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PREFACE 



This reference manual describes many of the capabilities available in 
Version 19 of the Rand editor, e. It supersedes Rand Note N-2239-RCC, 
which described Version 17 of e. 

The level of description presented here assumes that the user has prior 
experience with an on-line text editor. Individuals without such 
experience should first read the Self -Teaching Guide to Rand' s Text 
Processor, N-2056- 1-RCC . 

The authors wish to thank Susan Payne, Rosalind Chambers, and Gail 
Roberts for their extremely helpful technical reviews of this document. 
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HOW TO USE THIS REFERENCE MANUAL 



This manual uses different typefaces and symbols to denote the keys you 
must press on your keyboard. 



TYPEFACES 
bold 



Bold indicates that you must type characters exactly 
as they are shown. Thus, if you are told to type 

exit 

you must type exit to exit from the file. 



italics 



Italics indicate that you must type characters like 
the ones that are shown. They may be the name of a 
file or a number. Thus, if you are told to type 

e new filename 

you must type the letter e exactly as shown and a 
filename like newf ilename . 



<Brackets> Angled brackets indicate that you must press a key 

with a particular label on it. Thus, if you are 
told to press 

<Cmd> 

you must press the key with the label Cmd on it. 



<CR> 



This indicates that you must press the return or 
enter key. 



<Key+Key> This indicates that you must hold down the first key 

and then press the second one. Thus, if you are 
told to press 

<Ctrl+b> 

you must hold down the Ctrl key and then press the b 
key . 
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SYMBOLS 

| The "block" is used in conjunction with other 

characters to make the printer perform special tasks 
when printing your text. The block symbol appears 
as a bright box on your screen, and it looks like a 
| in this document. To insert a block symbol in 
your file, press <CntlChar> if you have an 
Ambassador or XL terminal or <Ctrl+\> if you have an 
older Ann Arbor terminal. 



1. INTRODUCTION 



The Rand editor, known as e, lets you type, view, and change files in an 
easy and natural way. Your terminal screen shows a portion of your file 
at a time, and you can move other portions into this "window" at will. 
You can type new characters and change existing ones. In addition, the 
editor lets you insert, delete, and move characters, lines, and 
rectangular portions of your file, much as you would use scissors and 
tape to edit a paper document. 

This document serves as a reference manual for Version 19 of the Rand 
editor. Section 2 describes the basic concepts you should master 
before using the editor. Section 3 describes editor commands, and 
Section 4 the editor function keys. The appendixes discuss how to deal 
with crashes, the function of editor work files, variations of the 
editor's cover command, special options that can be added to UNIX 1 
commands, and how to use different terminals and keyboards. 



1 UNIX is a trademark of Bell Laboratories. 
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2. CONCEPTS 



To use the editor, you first need to know some basic concepts concerning 
files you edit, the buffers in which you store text, and the comma files 
which contain the previous version of the file you are editing. 

WHAT ARE FILES? 

A file is a collection of text saved by the Text Processor. 
Naming a File 

You must give each file an individual identifying filename when you 
create it. The filename you choose: 

• Can contain up to 255 letters, numbers, dots, and dashes. 1 

• Cannot contain a blank space, because the editor will ignore 
all characters typed after the space. 

• Should not begin with a comma, because this convention is for 
special kinds of files that are automatically deleted from the 
system 24 to 48 hours after their creation. 

• Generally should not begin with a period, because files 
beginning with periods are "hidden" and are not listed with the 
standard files. 

• Must not be named core or a. out, because these files are 
automatically deleted from the system 24 to 48 hours after 
their creation. 

Editing a File 

To edit a file, type e filename <CR> in response to the % prompt. If 
the file does not already exist, respond to the prompt "Do you want to 
create filename"!" by typing y for yes. 

You should limit the text in your files to 1000 lines, and in most cases 
you should type text and formatting macros beginning in column 1 of 
those lines. 

The editor uses the window concept to let you view your file. The 
terminal screen is like a window that opens on part of the file. You 

x The full pathname can contain up to 1024 letters, numbers, dots, 
and dashes . 
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4 Concepts 



can use editor function keys to move the window forward and backward 
(and right and left) to view different portions of your file. 

The window normally shows columns 1 through 78 in your file. When the 
cursor reaches column 78, the window automatically moves 16 spaces to 
the right, moving any text at the left margin out of sight. To return 
your cursor to the left margin of your text, press <CR>. 

On the screen: 

• Hyphens (-) outline the top and bottom edges of the window. 

• Pluses (+) indicate: 

The four corners of the window. 

The location of tab stops where they appear on the top 
edge . 

The right margin where one appears at the right of the 
bottom edge . 

The left margin where one appears at the left of the bottom 
edge . 

• Colons (:) appear at the left and right edges of the window 
before you have reached the end of your file and at the right 
edge of the window after you have reached the end of your file. 

• Semi-colons (;) appear at the left edge of the window when you 
have reached the end of your file. 

• The greater-than character (>) appears at the right edge of the 
window when there is text that cannot be seen to the right of 
the window. 

• The less-than character (<) appears at the left edge of the 
window when there is text that cannot be seen to the left of 
the window (this occurs when the window has been moved to the 
right) . 

• Periods (.) outline windows other than the window in which you 
are currently working. 

Exiting and Saving a File 

When you want to save your file and leave the editor, press <Cmd> exit 
<CR>. You should save your file at least once every half hour. 
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The Cursor 

The cursor indicates the position where the next character typed will be 
placed in your file (and where it will print). Most commands take place 
at or following the cursor position. Depending on the kind of terminal 
you use, the cursor resembles either an underline character (_) or a 
block character (|) . In addition, bright blocks (|) sometimes appear on 
the four edges of the screen to target the column and line where the 
cursor is located. 

You can move the cursor by pressing <->>, <«->, <t>, <^>, <Bsp>, <Home>, 
<+Line>, <-Line>, <LineFeed>, <+Page>, <-Page>, <CR>, <Spacebar>, <+Tab>, 
<-Tab>, <+Word>, and <-Word>, and by using certain command sequences 
involving <+Sch> and <-Sch>. 

Alternating Files 

The editor allows you to alternate between several files without 
exiting. This enables you to move text between files and compare files. 
To move to an alternate file, press <Cmd> e newfilename <CR>. To move 
back to the original file, press <Alt> or <Ctrl+b> . (See description in 
Section 4 . ) 

Using Changes Files, #o and #p, to Restore Lost Text 

The editor maintains two "changes" files to help protect you from losing 
material that you have accidentally deleted or changed. These files are 
automatically deleted each time you exit from the editor: 

• The #o file contains all text centered, closed, filled, joined, 
justified, split, and deleted with <DelWord>, <Cmd> <Del>, or 
<Cmd> <Bsp> during the current editing session. 

• The #p file contains all text picked during the current editing 
session . 

To use these files, press <Cmd> e #o <CR> or <Cmd> e #p <CR>. This 
brings the changes file into the editing window as an alternate file. 
You may then pick and move text to the original file. Caution: Do not 
use <Close> to move material from these files. 



WHAT ARE BUFFERS? 

Buffers are temporary storage areas that exist only while you are in the 
editor. The editor uses five buffers to store text for special 
purposes: the adjust, close, erase, pick, and search buffers. 
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Adjust Buffer 

The adjust buffer contains the original version of the last material you 
centered, filled, or justified. Text is placed in the adjust buffer 
when you press <Cmd> center <CR>, <Cmd> fill <CR>, or <Cmd> justify <CR>. 
To retrieve text from the adjust buffer, press <Cmd> insert adjust <CR>. 
Material remains in the adjust buffer and may be retrieved repeatedly 
until you center, fill, or justify different material or until you exit 
from the file. 

Close Buffer 

The close buffer contains the last material you closed. Text is placed 
in the close buffer when you press <Close>, <Cmd> close <CR>, or <Cmd> 
<Bsp> while in the Insert Mode. To retrieve text from the close buffer, 
press <Cmd> <Close> or <Cmd> -close <CR>. Material remains in the close 
buffer and may be retrieved repeatedly until you close different 
material or until you exit from the file. 

Erase Buffer 

The erase buffer contains the last material you erased. Text is placed 
in the erase buffer when you press <Erase>, <Cmd> erase <CR>, or <Cmd> 
<DelChar>. To retrieve text from the erase buffer, press <Cmd> <Erase> 
or <Cmd> -erase <CR>. Material remains in the erase buffer and may be 
retrieved repeatedly until you erase different material or until you 
exit from the file. 

Pick Buffer 

The pick buffer contains the last material you picked. Text is placed 
in the pick buffer when you press <Pick> or <Cmd> pick <CR>. To 
retrieve text from the pick buffer, press <Cmd> <Pick> or <Cmd> -pick 
<CR>. Material remains in the pick buffer and may be retrieved 
repeatedly until you pick different material or until you exit from the 
file. 

Search Buffer 

The search buffer contains the last material for which you searched. 
Text is placed in the search buffer when you press <Cmd> word <+Sch> or 
<Cmd> word <-Sch>, or when you press <Cmd> <+Sch> or <Cmd> <-Sch> when 
the cursor is on the first character of the word being searched for. 
Material remains in the search buffer until you search for different 
material or until you exit from the file. If, however, you return to 
the file by typing e <CR> in response to the % prompt, the material you 
last searched for remains in the search buffer. 
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WHAT ARE COMMA OR BACKUP FILES? 

A comma file is a temporary copy of the file as it existed before the 
most recent editing session. When you exit normally, the editor renames 
the original file by preceding the original name with a comma. 

For example, the editor backs up a file named memo (the current file) 
with a file named ,memo (the previous version of this file) . The comma 
file is stored in the same directory as the modified file. All comma 
files are automatically deleted 24 to 48 hours after they are created. 

Comma files protect you from inadvertent mistakes. If you have made a 
serious error when you worked on the file, you can either: 

• Exit with the abort option (<Cmd> exit abort <CR>) and make the 
comma file into a permanent file (% cp ,memo memo <CR>) ; or 

• Without exiting from the editor, you can edit the comma file as 
an alternate file (<Cmd> e ,memo <CR>) and use the pick key or 
pick command to copy into your permanent file the section of 
the file as it existed before the editing error. 

If you exit with the abort option or if the system crashes, no comma 
file is created and any previous comma file is left unchanged. 



3. COMMANDS ISSUED FROM WITHIN THE EDITOR 



This section describes the commands you issue to the editor to perform 
such functions as inserting, deleting, and rearranging text. 

Occasionally, you can perform the same function either by using an 
editor command (described in this section), or by pressing an editor 
function key (described in Section 4). For example, you can remove the 
line on which the cursor is located either by pressing <Cmd> close <CR> 
or by pressing the <Close> key. 

Abbreviating Editor Commands 

Most editor commands can be abbreviated to their initial one, two, or 
three characters as long as these characters are not identical to those 
of some other editor command. For example, the window command can be 
abbreviated as w, wi, win, or even wind and windo. The join command can 
be abbreviated as jo and joi, but not j, because the justify command 
also begins with j . 

A few commands, such as tab, cannot be abbreviated. 

If you type an inadequate number of characters or if you abbreviate a 
command that cannot be abbreviated, the editor will display the 
following error message: Command ambiguous". 

Defining Areas for Editor Commands 

An area is any part of a file; it can be as small as one character or as 
large as the entire file. 

An area may be a default area, such as the default area for the fill 
command (one paragraph following the cursor position). 

You may also define an area by using: 

• A number in conjunction with the letter 1 (ell) to define lines 
or the letter p to define paragraphs. 

• An explicit description of the dimensions (lines x columns). 

• The mark function in conjunction with cursor movements. 

For example, <Cmd> fill <CR> fills two lines following the cursor and 
<Cmd> center 2p <CR> centers two paragraphs following the cursor. 

To close a rectangular area three lines long by four columns wide 
following the cursor position, explicitly describe the dimensions by 
pressing <Cmd> close 3x4 <GR>. 
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To fill an area defined by the mark function, press <Mark>, move the 
cursor, and then press <Cmd> fill <CR>. 



BOX: DRAWING A BOX 

The box command draws a box around a specified area. To draw a box: 

1. Place the cursor at the left edge of the area and press <Mark>. 

2. Move the cursor on the same line to the right edge of the area 
by pressing <-*>. 

3. Move the cursor to the bottom of the area by pressing <|>. 
(The number of lines and columns marked off is indicated in the 
mark message below the window, e.g., "MARK 4x32".) 

4. Press <Cmd> box <CR> . 

This command draws a box that consists of : 

• Hyphens (-) on the marked horizontal lines 

• Pipes (|) on the marked vertical lines 

• Pluses (+) at each corner. 

CAUTION: The box command erases characters on the lines where it 
inserts the "|", and "+" characters; it does not, however, erase 

characters within the box. 

You can also use the box command to draw horizontal and vertical lines. 
To draw a horizontal line: 

1. Press <Mark>. 

2. Move the cursor to the end of the line by pressing <-» . 

3. Press <Cmd> box <CR>. 
To draw a vertical line: 

1. Press <Mark>. 

2. Move the cursor one space to the right by pressing <-*■>. 

3. Move the cursor to the point where you want the line to end by 
pressing <|>. 

4. Press <Cmd> box <CR> . 
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n 



To remove a box: 

1. Press <Mark> . 

2. Move the cursor to mark the dimensions of the box. 

3. Press <Cmd> blot box <CR>. 

This leaves blank spaces where the box outline had been drawn. 



<Cmd> box <CR> 



| <Cmd> blot box <CR> 



I 



Places box around marked area| 

I 

Deletes box around marked [ 
area 



CAPS: CHANGING ALL LETTERS TO UPPERCASE 

The caps command changes all letters to uppercase in a rectangularly 
marked area. To use this command, place your cursor at the beginning of 
the area you want to change, press <Mark> , move the cursor, and press 
<Cmd> caps <CR>. 



| <Cmd> caps <CR> 



Changes all letters to upper- | 
case in a rectangularly j 
marked area 



CCASE: REVERSING LETTERS TO UPPER/LOWER CASE 

The cease command changes all uppercase letters to lowercase and all 
lowercase letters to uppercase in a rectangularly marked area. To use 
this command, place your cursor at the beginning of the area you want to 
change, press <Mark> , move the cursor, and press <Cmd> cease <CR>. 



<Cmd> cease <CR> 



Changes all uppercase 
letters to lowercase and all 
lowercase letters to upper- 
case in a rectangularly 
marked area 
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CENTER: CENTERING TEXT 

The center command centers text in your file. To center the line where 
the cursor is located, press <Cmd> center <CR>. To center several 
lines, press <Mark>, move the cursor to the last line to be centered, 
press <Cmd> center <CR>. You can also press <Cmd> center n <CR>, where 
n is the number of lines to be centered. (You cannot center a 
rectangularly marked area.) 

The line length of the center command is the default width of 75, the 
width specified by the last set right margin command (set rmar n) <CR>, 
or the width specified in the last center, fill, or justify command. To 
specify a width, press <Cmd> center width=n <CR>, where n is the number 
of characters per line. 

If you have made a mistake when centering text, press <Cmd> insert 
adjust <CR>. This command will insert the original uncentered version 
of the text at the cursor position. You must then delete the mistakenly 
centered text. You can retrieve this uncentered text only while you are 
in the current editing session and only before you issue another center, 
fill, or justify command. 



<Cmd> center <CR> 
<Cmd> center n <CR> 



Centers line 

Centers specified number of 
lines 



<Cmd> center width=n <CR> 
<Cmd> insert adjust <CR> 



Centers with specified width 
Restores centered text 



CLOSE, -CLOSE: REMOVING/RESTORING TEXT 

The close command removes characters, lines, or rectangular areas and 
moves remaining text so that no gaps are left in your file. (By 
contrast, the erase command removes characters, lines, or rectangular 
areas and leaves a blank space where they were.) Text removed by the 
close command is' placed in the close buffer. 

To close the line where the cursor is located, press <Cmd> close <CR>. 
To close a number of lines or a rectangular area, press <Mark>, move the 
cursor, and press <Cmd> close <CR>. You can also close lines by 
pressing <Cmd> close n <CR>, where n is the number of lines to be 
closed . 

To restore the last text you closed, press <Cmd> -close <CR>. Copies of 
the closed text can be inserted as many times and in as many places as 
you wish. 
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Any subsequent use of the close command will replace the text in the 
close buffer. Note: Pressing <Cmd> <Bsp> while in Insert Mode also 
replaces the contents of the close buffer with the newly deleted text. 

All material removed from a file by pressing <Cmd> close <CR> or <Cmd> 
<Bsp> during your current editing session is placed in the changes file 
(#o) . 



1 

| <Cmd> 


close <CR> 


Closes line | 


| <Cmd> 


close n <CR> 


Closes specified number of i 






lines | 


j <Cmd> 
i 


-close <CR> 


Restores closed text | 



COMMAND, -COMMAND: ISSUING A SERIES OF COMMANDS 

Usually commands are issued one at a time by pressing <Cmd>, typing the 
command, and pressing <CR> . If you wish to issue a series of commands 
without pressing <Cmd> each time, press <Cmd> command <CR>. The 
message "CMDS:" will appear below the screen. The editor remains in the 
constant Command Mode until you type <Cmd> -command <CR>. 

You cannot change the cursor position once you are in the constant 
Command Mode. 



<Cmd> command <CR> 



Places editor in constant 
Command Mode 



<Cmd> -command <CR> 



Takes editor out of constant 
Command Mode 



COVER: COVERING EXISTING TEXT 

If you use <Cmd> <Pick> or <Cmd> -pick <CR> to insert rectangularly 
marked material into your file (see the discussion of the pick command 
below), all existing material is moved to the right. 

You can, however, cover or write over existing material rather than move 
it to the right, by using the cover command. This command is especially 
useful when you are changing columns in a table or moving portions of a 
figure . 
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For example, suppose you have a table like the one below, and you wish 
to replace the numbers in the "Percent" column, using numbers from 
another part of your file: 



r 





Percent 


Number 


Alabama 


18 


12,000 


California 


23 


16,500 


Maryland 


17 


11,250 


New York 


24 


9,500 


Oregon 


20 


14,000 


Virginia 


43 


23,500 



L 



To copy the material you want to use, place your cursor at the upper 
left corner of the material, press <Mark>, move the cursor, and press 
<Pick>. The marked area must be rectangular. The material you pick 
might be the following numbers which you want to insert in the "Percent" 
column: 



I 23 | 
| 12| 
1 16 | 
I 21 1 
| 19 | 
I 39 | 



Place your cursor on the first figure of the first number in the 
"Percent" column and press <Cmd> cover pick <CR>. Your file will now 
look like: 





Percent 


1 

Number | 


[ Alabama 


23 


12,000 j 


| California 


12 


16,500 | 


| Maryland 


16 


11,250 j 


| New York 


21 


9,500 j 


| Oregon 


19 


14,000 j 


| Virginia 


39 


23,500 j 

1 



Everything in your buffer, both characters and blank spaces, now covers 
text in your file. Nothing is moved to the right. You can also use the 
cover command with rectangularly marked material stored in the close and 
erase buffers: <Cmd> cover close <CR>, or <Cmd> cover erase <CR>. 

CAUTION: When issuing the cover command, you must type the name of the 
buffer you use; do not press the key with the name of the buffer on it, 
such as <Close>, <Erase>, or <Pick>. 
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Appendix C describes other ways to insert rectangularly marked material 
from your close, erase, and pick buffers without shifting existing text 
to the right . 

I — ! 

| <Cmd> cover close <CR> Uses contents of close buffer | 

I to cover portion of file | 

j <Cmd> cover erase <CR> Uses contents of erase buffer | 

| to cover portion of file | 

j <Cmd> cover pick <CR> Uses contents of pick buffer j 

| to cover portion of file j 
I — I 



DELETE: DELETING THE CURRENT FILE WITHIN THE EDITOR 

To delete the file you are currently editing (in both the editor and the 
UNIX file system), press <Cmd> delete <CR>. The file is deleted 
immediately and you are moved either to the alternate file or to a file 
called scratch. When you exit from the alternate file or from scratch, 
the system responds with "DELETE: filename" . 

CAUTION: Make absolutely certain you want to delete the file. The 
delete command takes effect immediately. There is no way of retrieving 
a file once you have deleted it in this fashion. 



| <Cmd> delete <CR> Deletes current file j 
l I 



DWORD, -DWORD: DELETING/RESTORING A WORD 

To delete a single word or a series of characters up to a blank space 
and fill in the space left by the deletion, place the cursor on any 
letter or on the space immediately preceding the characters and press 
<Cmd> dword <CR>. 

To restore the word or characters deleted in this fashion, press <Cmd> 
-dword <CR>. 



j <Cmd> dword <CR> 


Deletes word at cursor J 




position ] 


j <Cmd> -dword <CR> 


Restores deleted word | 
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E: EDITING A FILE 

To enter the editor and edit a file, type e filename <CR> in response to 
the % prompt. 

To enter the editor and edit the file you most recently edited, type 
e <CR> in response to the % prompt. 

If you are already editing a file, you can edit an additional file (as 
an alternate file) by pressing <Cmd> e newfilename <CR>. 

If the file does not already exist, respond to the prompt "Do you want 
to create newfil enamel" by typing y for yes or n for no. 

If you are editing a file in a subdirectory and wish to edit as an 
alternate file a file in your main (or login) directory, press <Cmd> e 
~/ filename <CR>. The tilde (~) serves as an abbreviation for either 
/ a/ loginname or /b/loginname . 



<Cmd> e filename <CR> 
% e filename <CR> 
% e <CR> 



Brings up an alternate file 

Brings up a named file 

Brings up file most recently 
edited 



ERASE, -ERASE: ERASING/RESTORING TEXT 

The erase command removes characters, lines, or rectangular areas and 
leaves a blank space where they were. (By contrast, the close command 
removes characters , lines , or rectangular areas and moves the remaining 
text so that no gaps are left in your file.) Text closed by the erase 
command is placed in the erase buffer. 

To erase the line where the cursor is located, press <Cmd> erase <CR>. 
To erase a number of lines or a rectangular area, press <Mark>, move the 
cursor, and press <Cmd> erase <CR> . You can also erase lines by 
pressing <Cmd> erase n <CR>, where n is the number of lines to be 
erased . 

To restore the last text you erased, press <Cmd> -erase <CR>. Copies of 
the erased text can be inserted as many times and in as many places as 
you wish. 

Any subsequent use of the erase command will replace the text in the 
erase buffer. Note: Pressing <Cmd> <DelChar> also replaces the 
contents of the erase buffer with the newly deleted text. 

All material removed from a file by pressing <Cmd> erase <CR> or <Cmd> 
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<DelChar> during your current editing session is placed in the changes 
file (#o). 



<Cmd> erase <CR> Erases text, leaves blank | 

space | 

<Cmd> erase n <CR> Erases specified number of | 

lines j 

<Cmd> -erase <CR> Restores erased text j 

I 



EXIT, BYE: EXITING FROM A FILE 

To exit from the editor, press <Cmd> exit <CR> or <Cmd> bye <CR>. The 
edited file will be saved. 

You can also exit from the editor without saving the file with any of 
the following commands: 

<Cmd> exit nosave <CR> 
<Cmd> exit quit <CR> 
<Cmd> exit abort <CR> 
<Cmd> exit dump <CR> 

These commands perform the following functions: 











Updates 


Removes 


Removes 








Saves 


state 


keystroke 


change 








edited 


file 


file 


file 








file 


(.esl) 


(.ekl) 


(.eel) 


<Cmd> 


exit 


<CR> 


yes 


yes 


yes 


yes 


<Cmd> 


exit 


abort <CR> 


no 


no 


no 


yes 


<Cmd> 


exit 


dump <CR> 


no 


no 


no 


no 


<Cmd> 


exit 


nosave <CR> 


no 


yes 


yes 


yes 


<Cmd> 


exit 


quit <CR> 


no 


no 


yes 


yes 



See Appendix B for descriptions of state, keystroke, and change files. 

Normally, you will exit from files with either the exit, exit nosave, or 
exit abort commands. When your editing session contains no serious 
editing mistakes, exit the editor and save the file with <Cmd> exit 
<CR> . 

If your editing session contains a serious mistake, ruining all or part 
of the file, you can negate the final portion of the editing session 
with exit abort: 
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1. Press <Cmd> exit abort <CR>. 



2 . Type e <CR> in response to the % prompt . 

3. Choose option 2, when prompted with the crash message (see 
Appendix A) . 

4. Watch the replay of your editing session on the screen. At a 
point just before the mistake occurred, interrupt the replay by 
pressing <Int> if you have a newer Ann Arbor, Ambassador, or XL 
terminal, or <Ctrl+c> if you have an earlier-model Ann Arbor 
terminal. The replay occurs quickly, so some skill is required 
to interrupt at the desired point. 



5. Exit from the file with <Cmd> exit <CR>. 



Sometimes you may wish to cancel all changes made during an editing 
session. In that case, exit the file with <Cmd> exit nosave <CR>. This 
option deletes the entire editing session, but will save the original 
version of your file. 



<Cmd> exit <CR> 



Exits from the editor and 
saves file 



<Cmd> exit abort <CR> 



Exits from the editor without | 
saving file 



<Cmd> exit dump <CR> 



Exits from the editor without | 
saving file 



<Cmd> exit nosave <CR> 



Exits from the editor without | 
saving file 



<Cmd> exit quit <CR> 



Exits from the editor without | 
saving file 



J 



FEED: ISSUING UNIX COMMANDS FROM WITHIN THE EDITOR 

You can use some UNIX commands while you are in the editor by pressing 
<Cmd> feed UNIXcommand <CR>. 

For example, you can use the UNIX sort command to alphabetize lines in a 
marked area by pressing <Mark> <|> <Cmd> feed sort <CR>. This command 
keeps the original version of the lines and inserts the alphabetized 
version at the cursor position. (By contrast, the run sort command 
deletes the original version of the lines and inserts the alphabetized 
version in its place.) 
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CAUTION: If you experience a crash and have used the feed command, a 
replay of the editing session can produce unexpected results. For 
example, the output from the UNIX sort command can vary if you have 
added or deleted lines in the list being alphabetized between the time 
you originally issued the feed sort command and the time you recovered 
from the crash. 



| <Cmd> feed UNIXcommand <CR> Executes UNIXcommand and | 
| inserts output at cursor | 
1 position | 
I I 



FILL: CONTROLLING THE RIGHT MARGIN 

The fill command moves text so that each line is filled with characters 
up to, but not beyond, the right margin. The default line length is 75 
characters . 

To fill a paragraph, move the cursor to the first line of the paragraph 
and press <Cmd> fill <CR> . This command evens out the line length 
beginning with the line the cursor is on and ending at the first totally 
blank line thereafter. 

CAUTION: If you use the fill command, be certain each paragraph is 
followed by a totally blank line. The fill command treats formatting 
macros (such as .pp and . ip o) as part of the text to be filled. 

The line length used by the fill command is the default width of 75, the 
width specified by the last set right margin command (set rmar n <CR>) , 
or the width specified in the last center, fill, or justify command. To 
specify a different width, press <Cmd> fill width=n <CR>, where n is the 
number of characters per line. 

If you have made a mistake when filling text, press <Cmd> insert adjust 
<CR>. This command will insert the original unfilled version of the 
text at the cursor position. You must then delete the mistakenly filled 
text. You can retrieve this unfilled text only while you are in the 
current editing session and only before you issue another center, fill, 
or justify command. 



| <Cmd> fill <CR> Fills text 

I <Cmd> fill Width=« <CR> Fills text to specified width 

I <Cmd> insert adjust <CR> Restores unfilled text 

l 
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GOTO: MOVING THE CURSOR TO A SPECIFIED LINE 

You can move the cursor to a specific line number in a file by pressing 
either <Cmd> goto n <CR> or <Cmd> n <CR>, where n is the line number. 

To go to the beginning of a file, press <Cmd> goto <CR>, <Cmd> 1 <CR>, 
or <Cmd> goto beginning <CR>. To go to the end of a file, press <Cmd> 
goto end <CR>. 

To go to the beginning of a range that you have set, press <Cmd> goto 
rbeginning <CR>. To go to the end of a range that you have set , press 
<Cmd> goto rend <CR>. 



<Cmd> n <CR> 



Moves cursor to designated 
line 



<Cmd> goto n <CR> 



Moves cursor to designated 
line 



<Cmd> goto beginning <CR> 



Moves cursor to beginning of 
file 



<Cmd> goto <CR> 

<Cmd> goto end <CR> 

<Cmd> goto rbeginning <CR> 

<Cmd> goto rend <CR> 



Moves cursor to beginning of 
file 

Moves cursor to end of file 

Moves cursor to beginning of 
range 

Moves cursor to end of range 



INSERT ADJUST: RETRIEVING CENTERED/FILLED/JUSTIFIED TEXT 

You may recover the original version of lines that have been centered, 
filled, or justified by pressing <Cmd> insert adjust <CR> . These lines 
are inserted at the cursor position. They do not replace the centered, 
filled, or justified text. You can retrieve this text only while you 
are in the current editing session and only before you issue another 
center, fill, or justify command. 



<Cmd> insert adjust <CR> 



Restores centered, filled, or 
justified text to original 
state 
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JOIN, -JOIN: JOINING/SPLITTING LINES 

The join command joins two lines. The line the cursor is on is 
lengthened by appending the following line of text to it. The join 
command deletes blank spaces or blank lines preceding the line to be 
joined. To issue this command, press <Cmd> join <CR>. The cursor can 
be placed anywhere on the line when using the join command. 

The -join command splits a line at the cursor position. To issue this 
command, press <Cmd> -join <CR>. 



1 

| <Cmd> 
1 


join <CR> 


I 

Joins two lines of text | 


| <Cmd> 


-join <CR> 


; 

Returns joined line to its j 


1 
i 




original state 

i 



JUSTIFY: CONTROLLING THE RIGHT MARGIN 

The justify command moves text and adds blank spaces where necessary so 
that each line ends exactly at the right margin. The default line 
length is 75 characters. 

To justify a paragraph, move the cursor to the first line of the 
paragraph and press <Cmd> justify <CR>. This command justifies all 
lines beginning with the line the cursor is on and ending at the first 
totally blank line thereafter. 

CAUTION: If you use the justify command, be certain each paragraph is 
followed by a totally blank line. The justify command treats formatting 
macros (such as .pp and . ip o) as part of the text to be justified. 

The line length used by the justify command is the default width of 75, 
the width specified by the last set right margin command (<Cmd> set 
rmar n <CR>), or the width specified in the last center, fill, or 
justify command. To specify a different width, press <Cmd> justify 
width=n <CR> , where n is the number of characters per line. 

If you have made a mistake when justifying text, press <Cmd> insert 
adjust <CR>. This command will insert the original unjustified version 
of the text at the cursor position. You must then delete the mistakenly 
justified text. You can retrieve this unjustified text only while you 
are in the current editing session and only before you issue another 
center, fill, or justify command. 
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j <Cmd> justify <CR> 


Justifies text \ 


j <Cmd> justify width=n <CR> 


Justifies text to specified | 




width j 


j <Cmd> insert adjust <CR> 


Restores unjustified text j 



NAME: RENAMING A FILE WITHIN THE EDITOR 

To rename a file while you are in the editor, press <Cmd> name 
newfilename <CR>. The renaming takes place immediately. 



| <Cmd> name newfilename <CR> Renames current file j 
l — I 



OPEN: INSERTING BLANK LINES 

The open command inserts blank lines or rectangular areas in a file. To 
insert a blank line where the cursor is located, press <Cmd> open <CR>. 
To insert a number of blank lines or a blank rectangular area, press 
<Mark>, move the cursor to define the area you wish to open, and press 
<Cmd> open <CR>. 

You can also insert blank lines by pressing <Cmd> open n <CR>, where n 
is the number of blank lines to be inserted in the file. 



| <Cmd> open <CR> Opens blank line 

I 

| <Cmd> open n <CR> Opens specified number of 

j blank lines 

i . 



PICK, -PICK: COPYING/INSERTING TEXT 

The pick command copies characters, lines, or rectangular areas into 
your pick buffer, from which copies can be placed anywhere in the file. 
It does not change the material that is picked- -your text will appear 
untouched . 

To pick the line on which the cursor is located, press <Cmd> pick <CR> . 
To pick a number of lines or a rectangular area, press <Mark>, move the 
cursor, and press <Cmd> pick <CR>. You can also pick lines by pressing 
<Cmd> pick n <CR>, where n is the number of lines to be picked. 

To place copies of the text stored in the pick buffer anywhere in your 
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file, move the cursor to the desired location and press <Cmd> -pick 
<CR>. Copies of the picked text can be inserted as many times and in as 
many places as you wish. 

Any subsequent use of the pick command will replace the text in the pick 
buffer . 

All material picked during the current editing session is placed in the 
changes file (#p) . 



<Cmd> pick <CR> Places text in pick buffer 

<Cmd> pick n <CR> Places specified number of 

lines in pick buffer 

<Cmd> -pick <CR> Inserts contents of pick 

buffer 



RANGE, -RANGE, ? RANGE: SPECIFYING LINES FOR SEARCH/REPLACE 

The range command specifies a range of lines when using the search or 
replace commands. This is useful when issuing multiple commands on the 
same area of the file. 

To issue this command, press <Mark> , move the cursor to the last line to 
be included in the range, and press <Cmd> range <CR>. You can also 
define a range by pressing <Cmd> range n <CR>, where n is the number of 
lines in the range following the cursor position. (You cannot set a 
range in a rectangularly marked area.) 

When a range is specified, the search or replace commands can be issued 
only when the cursor is within that range. "=RANGE" at the bottom of 
the screen indicates that you have set a range and the cursor is within 
the range. "<RANGE" or ">RANGE" at the bottom of the screen indicates 
that the cursor is located either before or after the range. 

To remove the range, press <Cmd> -range <CR>. To set the same range 
again, press <Cmd> range <CR>. 

To go to the beginning or end of a range, press <Cmd> goto rbeginning 
<CR> or <Cmd> goto rend <CR>. To determine the number of lines in a 
range, press <Cmd> ? range <CR>. 
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<Cmd> range <CR> 
<Cmd> range n <CR> 
<Cmd> -range <CR> 
<Cmd> ? range <CR> 

<Cmd> goto rbeginning <CR> 

<Cmd> goto rend <CR> 



Specifies a range 

Specifies a range 

Removes a range 

Displays number of lines 
within range 

Moves cursor to beginning of 
range 

Moves cursor to end of range 



REDRAW: REMOVING EXTRANEOUS CHARACTERS FROM SCREEN 

To redraw the screen and eliminate extraneous characters (such as system 
messages, noise characters, or garbage characters), press <Cmd> redraw 
<CR>. This is helpful when system messages appear in the middle of your 
file or when you want to determine if strange characters are actually 
part of your file. 



<Cmd> redraw <CR> 



Removes unwanted characters 
from screen 



REGULAR EXPRESSION: USING SPECIAL CHARACTERS WITH 
SEARCH/REPLACE 

The Regular Expression Mode enables you to use special characters when 
searching for or replacing characters or words in a file. 1 

When searching for or replacing characters in the Regular Expression 
Mode, the following characters have special meanings: periods, 
backslashes, left brackets, carets, dollar signs, and 
asterisks . 

To enter the Regular Expression Mode, press <Cmd> regexp <CR>. When 
you are in the Regular Expression Mode, you will see "RE" displayed 
beneath the window. 



To turn off the Regular Expression Mode, press <Cmd> -regexp <CR>. 



1 For more information on using regular expression, consult the UNIX 
Programmer' s Manual by typing man ed <CR> in response to the % prompt. 
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| <Cmd> regexp <CR> Turns on Regular Expression | 

I Mode j 

j <Cmd> -regexp <CR> Turns off Regular Expression j 
I Mode 1 
l I 

The following examples demonstrate how to use the Regular Expression 
Mode with the <+Sch> key and with the replace command. You can also use 
the Regular Expression Mode with the <-Sch> key and with the replace 
interactive, replace show, and -replace commands. 

Period takes the place of any one character: 

i ~ 1 

| <Cmd> J .ties <+Sch> Finds subsequent words where | 

I J and nes are separated by a | 

I single character. This | 

i locates occurrences of Janes, \ 

| Jones, and Junes \ 

j <Cmd> replace /J. nes /Jones/ <CR> j 

I Substitutes Jones for all | 

I subsequent words where J and | 

j nes are separated by a single | 

| character . This changes | 

i words like Janes and Junes to | 

! Jones I 

l — I 

Brackets define a range of alternative characters: 



<Cmd> [Aa]ffect <+Sch> Finds subsequent occurrences | 

of both Affect and affect [ 

<Cmd> [2-5] <+Sch> Finds subsequent occurrences | 

of 2, 3, 4, and 5 j 

<Cmd> [C-E] <+Sch> Finds subsequent occurrences | 

of C, D, and E \ 

<Cmd> [C-EjC-e] <+Sch> Finds subsequent occurrences | 

of C, D, E, c, d, and e | 

<Cmd> replace /[C-E]/?/ <CR> Substitutes any subsequent j 

C, D, or E with ? j 
1 
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Caret in conjunction with brackets excludes characters it precedes: 



<Cmd> [~C-E,c-e] <+Sch> 



Finds subsequent occurrences 
of all characters except 
C, D, Ej c, d, and e 



<Cmd> replace /["C-E]/?/ <CR> Substitutes all subsequent 

characters except C, D, and 
E with ? 



Caret not in conjunction with brackets indicates beginning of a line: 



<Cmd> 'Dear <+Sch> 



Finds subsequent occurrences 
where Dear appears at the 
beginning of a line 



<Cmd> replace / 'Dear /Dearest/ <CR> 

Substitutes Dear with Dearest 
in all subsequent places 
where Dear appears at the 
beginning of a line 



Dollar sign indicates end of a line: 



<Cmd> 1985$ <+Sch> 



Finds subsequent occurrences 
where 1985 appears at the end 
of a line 



<Cmd> replace /1985$/1986/ <CR> 

Substitutes 1985 with 1986 in 
all subsequent places where 
1985 appears at the end of a 
line 
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Asterisk used in conjunction with period or brackets takes the place 
of any number of characters: 



| <Cmd> hyper ."ism <+Sch> Finds subsequent occurrences | 

] where hyper and ism are [ 

! separated by any number of | 

I characters. This locates | 

I occurrences of such words as | 

I hyperthyroidism and | 

j hyperparathyroidism |[ 

| <Cmd> hyper [a-z]" ism <+Sch> Finds subsequent occurrences j 

I where hyper and ism are j 

I separated by any number of [ 

! lowercase characters . This | 

I locates occurrences of such | 

! words as hyperthyroidism and | 

I thy per parathyroid ism, but not | 

I hyperTHYROIDism j 

j <Cmd> replace /hyper ."ism/hyopthryoidism/ <CR> j 

| Substitutes subsequent words | 

i where hyper and ism are i 

i separated by any number of | 

[ characters with | 

I hypothryodism \ 

l I 

Backslash causes Regular Expression Mode to ignore the meaning of one 
of its special characters: 

r — 1 

[ <Cmd> \ . <+Sch> Finds subsequent occurrences [ 

I of all periods rather than of | 

I all single characters | 

I <Cmd> replace /\./?/ <CR> Substitutes all subsequent j 
| periods (rather than all | 

I single characters) with ? j 

l I 



REPLACE, -REPLACE: REPLACING TEXT 

The replace command substitutes characters or words for other characters 
or words . 

To replace all occurrences of text with newtext following the cursor 
position, press! <Cmd> replace /text /newtext / <CR>. To replace all 
occurrences of text with newtext in the opposite direction, press <Cmd> 
-replace /text /newtext/ <CR>. 
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The text that is searched for and the text that replaces it can be 
separated in the command by a variety of characters including /, ', 
and +. Use these characters only if they are not part of the original 
or replacement text. 

The replace show option allows you to see each replacement as it occurs 
on the screen. To use this option, press <Cmd> replace show 
/text /newtext/ <CR>. You can interrupt the replacements at any time by 
pressing <Int> if you have a newer Ann Arbor, Ambassador, or XL 
terminal, or <Ctrl+c> if you have an earlier-model Ann Arbor terminal. 
The replace is performed quickly, so some skill is required to interrupt 
it at the desired point. 

The replace interactive option allows you to replace only selected 
occurrences of text with newt ext . To use this option, press <Cmd> 
replace interactive /text /newt ext / <CR>. This moves the cursor to the 
first occurrence of text. Pressing <Repl> substitutes newtext for text. 
To find the next occurrence of text, press <+Sch>. If you do not wish 
to replace text with newtext, press <+Sch> rather than <Repl>. 

The replace command will also work with a marked area of full lines; 
however, it will not work on a rectangularly marked area. 

For additional ways to replace text, see the regular expression and 
range commands in this section. 



<Cmd> replace /a/b/ <CR> Replaces a with b from j 

cursor to end of file | 

<Cmd> -replace /a/b/ <CR> Replaces a with b from | 

cursor to beginning of file | 

<Cmd> replace show /a/b/ <CR> Replaces a with b, showing j 

each time replace occurs | 

<Cmd> replace interactive /a/b/ <CR> j 

Replaces a with b only if | 

<Repl> is pressed | 

1 



RUN: ISSUING UNIX COMMANDS FROM WITHIN THE EDITOR 

You can use some UNIX commands while you are in the editor by pressing 
<Cmd> run UNIXcommand <CR>. 

For example, you can use the UNIX sort command to alphabetize lines in a 
marked area by pressing <Mark> <|> <Cmd> run sort <CR>. This command 
deletes the original version of the lines and inserts the alphabetized 
version at the cursor position. (By contrast, the feed command keeps 
the original version of the lines and inserts the alphabetized version 
at the cursor position.) 
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CAUTION: If you experience a crash and have used the run command, a 
replay of the editing session can produce unexpected results. For 
example, the output from the UNIX sort command can vary if you have 
added or deleted lines in the list being alphabetized between the time 
you originally issued the run sort command and the time you recovered 
from the crash. 



| <Cmd> run UNIXcommand <CR> Executes UNIXcommand and 
I inserts output at cursor 

I position 



SAVE: SAVING CURRENT FILE WITHOUT EXITING FROM THE EDITOR 



The save command is a convenient way of backing up a modified file 
before attempting some new, dramatic editing. To save a copy of the 
file being edited, press <Cmd> save newfilename <CR> . The newfilename 
cannot be the name of the file being edited. The save command takes 
effect immediately. 



| <Cmd> save newfilename <CR> Makes copy of current file 
! giving it new filename 



SET: CHANGING DEFAULTS FOR EDITOR KEYS AND COMMANDS 

The set option allows you to change defaults for a number of editor keys 
and editor commands. To change a default, press <Cmd>, type in the 
appropriate set command (shown below), and press <CR>. The following 
options are now available with the set command: 

Line Keys (default is one-fourth screen) 



<Cmd> set + line n <CR> 



Sets <+Line> to move file n 
lines forward 



<Cmd> set -line n <CR> 



Sets <-Line> to move file n 
lines backward 



<Cmd> set line n <CR> 



Sets <+Line> and <-Line> to 
move your file n lines 
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Page Keys (default is 1 screen) 



<Cmd> set + page n <CR> Sets <+Page> to move file n 

screens forward 

<Cmd> set -page n <CR> Sets <-Page> to move file n 

screens backward 

<Cmd> set page n <CR> Sets <+Page> and <-Page> to 

move your file n screens 



Window Keys (default is 16 columns) 



<Cmd> set left n <CR> Sets <Left> and <Gtrl+a> to 

move window n columns to the 
left 

<Cmd> set right n <CR> Sets <Right> and <Ctrl+s> to 

move window n columns to the 
right 

<Cmd> set window n <CR> Sets <Left>, <Ctrl+a>, 

<Right>, and <Ctrl+s> to move 
window n columns 



Word Keys (default is whitespace) 



<Cmd> set worddelim alphanum <CR> 

Sets <+Word> and <-Word> to 
move cursor to first 
character of following or 
preceding word or to first 
character following or 
preceding a nonalphanumeric 
character (e.g., #) 

<Cmd> set worddelim whitespace <CR> 

Sets <+Word> and <-Word> to 
move cursor to first 
character of following or 
preceding word 



Line Width (default is 75 columns) 
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| <Cmd> set width n <CR> 



Sets line width to n coll 



Margins (default: left margin column 1; right margin column 75; stick) 



<Cmd> set Imar n <CR> 



Sets left margin at the nth 
column 



<Cmd> set rmar n <CR> 



Sets right margin at the nth 
column 



<Cmd> set stick <CR> 



<Cmd> set nostick <CR> 



When word wrap is turned off, 
causes cursor to stop at 
right margin 

When word wrap is turned off, 
causes cursor not to stick at | 
right margin 



Determining Current Set Options 



| <Cmd> set ? <CR> 



Shows values of set options 
at bottom of screen 



SPLIT, -SPLIT: SPLITTING/RESTORING LINES 

The split command divides one line into two at the cursor position. The 
right-hand side of the line, including the character at the cursor 
position, is inserted as a new line on the line below, and the window is 
redrawn. To issue this command, press <Cmd> split <CR>. 

The -split command restores the line to its original version. To issue 
this command, press <Cmd> -split <CR>. 



| <Cmd> split <CR> 


Splits line into two lines j 


j <Cmd> -split <CR> 


Returns split line to its j 
original state j 
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STOP: EXITING QUICKLY FROM A FILE 

The stop command exits quickly from a file, returning you to the % 
prompt. This does not save your file, which requires extra time. To 
issue this command, press <Cmd> stop <CR>. 

You may not edit another file at this time. To resume editing this 
file, type fg <CR> in response to the % prompt. This returns you to 
your file. 

If you have issued the stop command, you must bring your file into the 
foreground" before logging out of the Text Processor. Otherwise, you 
will receive a message saying "There are stopped jobs" and you will not 
be allowed to logout. 



| <Cmd> Stop <CR> Exits quickly from file j 

1 , I 

| % fg <CR> Returns you to file exited | 

! with stop command | 

I : I 



TAB, -TAB: SETTING/REMOVING TABS 

To set tab stops in addition to those already displayed at the top of 
the screen (every 8 columns), press <Cmd> tab n <CR>, where n is one or 
more column numbers separated by blanks. If n is not specified, the tab 
is set where the cursor is positioned. 

To clear a tab stop at the cursor position, press <Cmd> -tab <CR>. 



j <Cmd> 


tab n <CR> 


Sets tab(s) 


in designated | 






column(s) 




| <Cmd> 


-tab <CR> 


Removes tab 


at cursor | 






position 





TABFILE: CREATING A SEPARATE FILE WITH TAB STOPS 

Tabfile sets tabs according to a file containing a list of column 
numbers separated by blanks. To set tabs using this command, press 
<Cmd> tabfile filename <CR>, where fil ename is the name of a file 
containing the column numbers of the tab stops. The file with the tabs 
must be created and saved before editing the text file. Note: This 
command does not erase any existing tabs; it merely inserts additional 
tabs . 
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| <Cmd> tabfile filename <CR> Sets tabs from a file 

| containing column numbers 



TABS, -TABS: SETTING/REMOVING MULTIPLE TABS 

To set multiple tabs in addition to those already set (every 8 columns), 
press <Cmd> tabs n <CR>, where n is every nth column beginning with 
column 1. For example, pressing <Cmd> tabs 5 <CR> sets tabs in columns 
5, 10, 15, 20, etc. 

To remove all tabs press <Cmd> -tabs <CR>. This command can also be 
used to clear tabs in every nth column by pressing <Cmd> -tabs n <CR>, 
where n is every nth column beginning with column 1. 

i 1 
| <Cmd> tabs n <CR> Sets tabs every nth column | 

I <Cmd> -tabs <CR> Removes all tabs | 

| <Cmd> -tabs n <CR> Removes tabs in every nth | 
| column | 
l I 



TRACK, -TRACK: TRACKING CURRENT AND ALTERNATE FILES 

The track command causes the current file and the alternate file to 
track each other. Thus, if you move the current file's window two 
screens forward, the alternate file's window also moves two screens 
forward. This command is useful when comparing the contents of two 
files . 

To issue this command, press <Cmd> track <CR>. "TRACK" at the bottom of 
the screen indicates the track command is in effect. 

To turn off tracking, press <Cmd> -track <CR>. 



<Cmd> track <CR> Tracks current and alternate 

files 



<Cmd> -track <CR> 



Removes tracking with 
alternate file 
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-UPDATE, UPDATE: EXITING FROM A FILE WITHOUT SAVING CHANGES 



If you are editing a file and do not want to save the changes you have 
made, press <Cmd> -update <CR> . This command causes the editor to 
ignore all changes made during the current editing session, both before 
and after you issue the -update command. This command takes effect when 
you exit from the file. 

The -update command is especially useful when you are editing several 
files as alternate files and do not wish to save the changes you have 
made in one or more (but not all) of them. Bring onto the screen each 
of the files with changes you do not want to save and then press <Cmd> 
-update <CR>. 

If you then change your mind while still in the current editing session, 
you can override the -update command by pressing <Cmd> update <CR>; the 
changes made throughout the editing session will be saved. 



WINDOW, -WINDOW: OPENING/REMOVING AN ALTERNATE WINDOW 

To create a window, position the cursor either on the left or the top 
edge of the screen, but not in the top left-hand corner. Press 
<Cmd> window newf ilename <CR>. A second window will be drawn on the 
screen, and newf ilename will become the current file. 

Windows are numbered in the order in which they were created. To move 
the editor from window to window, press <ChgWin> or <Ctrl+z>. To move 
to a particular window, press <Cmd> n <ChgWin> or <Cmd> n <Ctrl+z>, 
where n is the number of the window. 

You can create a new window with the current file in it by pressing 
<Cmd> window <CR>. 



<Cmd> -update <CR> 



Does not save changes during 
current editing session 



<Cmd> update <CR> 



Cancels -update command 



To remove the last window created, press <Cmd> -window <CR>. 
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<Cmd> window <CR> Creates window with current | 

file in it | 

<Cmd> window filename <CR> Creates window with named j 

file in it ] 

<Cmd> -window <CR> Removes last window created j 
I 



WP, -WP: TURNING ON/OFF WORD WRAP 

The Word Wrap Mode causes the cursor to return automatically to the 
following line when it reaches the right margin. The default right 
margin is 75. It can be changed by a set rmar n command or by a 
width -n option added to an editor command. 

Word wrap is the default mode for the editor. When you are in the Word 
Wrap Mode, you will see "WP" displayed beneath the window. You can turn 
off the Word Wrap Mode by pressing <Cmd> -wp <CR>. To turn it back on, 
press <Cmd> wp <CR> . 

If you mark an area and then turn on word wrap, the boundaries of the 
marked area become your left and right margin settings. 



| <Cmd> 


wp <CR> 


Turns 


on Word Wrap Mode | 


j <Cmd> 


-wp <CR> 


Turns 


off Word Wrap Mode | 



SUMMARY OF EDITOR COMMANDS 



Command 



What the Command Does 



blot box 

box 

caps 

cease 

center 

close 

-close 

command 

-command 

cover close 

cover erase 

cover pick 

delete 

dword 

-dword 

e filename 

erase 

-erase 



Deletes box around marked area 

Places box around marked area 

Changes all letters to uppercase in a 
rectangularly marked area 

Changes all uppercase letters to lowercase and 
all lowercase letters to uppercase in a 
rectangularly marked area 

Centers line 

Removes line 

Restores closed text 

Places editor in constant Command Mode 

Takes editor out of constant Command Mode 

Uses contents of close buffer to cover portion 
of file 

Uses contents of erase buffer to cover portion 
of file 

Uses contents of pick buffer to cover portion 
of file 

Deletes current file 

Deletes word at cursor position 

Restores deleted word 

Brings up an alternate file 

Erases text; leaves blank space 

Restores erased text 
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Command 



What the Command Does 



exit 

exit abort 
exit dump 
exit nosave 
exit quit 
feed UNIXcommand 

fill 

goto beginning 
goto end 
goto n 

goto rbeginning 
goto rend 
insert adjust 

join 
-join 
justify 
n 

name filename 

open 

pick 

-pick 



Exits from the editor and saves file 

Exits from the editor without saving file 

Exits from the editor without saving file 

Exits from the editor without saving file 

Exits from the editor without saving file 

Executes UNIXcommand and inserts output at 
cursor position 

Fills text 

Moves cursor to beginning of file 

Moves cursor to end of file 

Moves cursor to designated line 

Moves cursor to beginning of range 

Moves cursor to end of range 

Restores centered, filled, or justified text 
to original state 

Joins two lines of text 

Returns joined line to its original state 
Justifies text 

Moves cursor to designated line 

Renames current file 

Inserts blank line 

Places text in pick buffer 

Inserts contents of pick buffer into file 
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Command 



What the Command Does 



range 

-range 

? range 

redraw 

regexp 

-regexp 

replace /a/b/ 

-replace /a/b/ 

replace interactive /a/b/ 
replace show /a/b/ 

run UNIXcommand 

save newfilename 

set left n 

set line n 
set +line n 
set -line n 
set lmar n 
set page n 
set +page n 



Specifies a range 
Removes a range 

Displays number of lines within range 

Removes unwanted characters from screen 

Turns on Regular Expression Mode 

Turns off Regular Expression Mode 

Replaces a with b from cursor position to end 
of file 

Replaces a with b from cursor position to 
beginning of file 

Replaces a with b when <Repl> is pressed 

Replaces a with b showing each time replace 
occurs 

Executes UNIXcommand and inserts output at 
cursor position 

Makes copy of current file, giving it new 
filename 

Sets <Left> and <Ctrl+a> to move window n 
columns to the left 

Sets <+Line> and <-Line> to move file n lines 
Sets <+Line> to move file n lines forward 
Sets <-Line> to move file n lines backward 
Sets left margin at the nth column 
Sets <+Page> and <-Page> to move file n screens 
Sets <+Page> to move file n screens forward 
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Command 



What the Command Does 



set -page n 
set right n 

set rmar n 
set nostick 

set stick 

set width n 
set window n 

set worddelim alphanum 

set worddelim whitespace 

set ? 

split 

-split 

stop 

tab n 

-tab 

tabfile filename 

tabs n 
-tabs 
-tabs n 



Sets <-Page> to move file n screens backward 

Sets <Right> and <Ctrl+s> to move window n 
columns to the right 

Sets right margin at the nth column 

When word wrap is turned off, causes cursor 
not to stick at right margin 

When word wrap is turned off, causes cursor to 
stick at right margin 

Sets line width to n columns 

Sets <Left>, <Ctrl+a>, <Right>, and <Ctrl+s> 
to move window n columns 

Sets <+Word> and <-Word> to move cursor to 
first character of following or preceding word 
or to first character following or preceding a 
nonalphanumeric character (e.g., #) 

Sets <+Word> and <-Word> to move cursor to 
first character of following or preceding word 

Shows values of set options at bottom of screen 

Splits line into two lines 

Returns split line to its original state 

Exits quickly from file, without saving file 

Sets tab(s) in designated column(s) 

Removes tab at cursor position 

Sets tabs from a file containing column 
numbers 

Sets tabs in every nth column 
Removes all tabs 

Removes tabs in every nth column 
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Command What the Command Does 

i 1 

| track Tracks current and alternate files j 

| -track Removes tracking with alternate file \ 

| update Cancels -update command j 

| -update Does not save changes during current | 

I editing session | 

| window Creates window with current file in it j 

| window file Creates window with named file in it j 

| -window Removes last window created j 

I wp Turns on Word Wrap Mode j 

| - wp Turns off Word Wrap Mode | 

I — I 



4. EDITOR FUNCTION KEYS 



This section describes the keys on your terminal that are used to 
perform special functions when you are using the editor. 

Different terminals may label the same function key in different ways. 
For example, the key used to issue a command to the editor is labeled 
<Arg>, <Brk>, <Brk/Cmd>, or <Cmd> depending on what kind of terminal you 
use . 

The three most common terminals currently in use at Rand are Ann Arbor, 
Ann Arbor Ambassador, and Ann Arbor XL terminals. (The label on the 
front of the terminal will tell you what kind you are using.) Newer Ann 
Arbor, Ambassador, and XL terminals have keys (e.g., <Int>) for 
functions that require a keystroke sequence (e.g., <Ctrl+c>) on earlier- 
model Ann Arbor terminals. Ambassador and XL terminals also have keys 
(e.g., <Erase>) for functions that require an editor command (e.g., 
<Cmd> erase <CR>) on other Ann Arbor terminals. 

<ALT>: MOVING TO AN ALTERNATE FILE 

Pressing <Alt> moves the cursor to an alternate file. If you have no 
alternate file, the editor will display the following error message: 
No alternate file". (Press <Ctrl+b> on earlier-model Ann Arbor 
terminals . ) 



I <Alt> Moves cursor to alternate file I 
I I 



<ARG>: ISSUING A COMMAND 

See <Cmd>. 



<ARROW KEYS>: MOVING THE CURSOR 

Your terminal has four arrow keys: <-►>, «->, <t>, and <b> . These keys 
move the cursor without erasing any text (unlike <Bsp> and <Spacebar>) . 

When the cursor is at the right side of the window and you press <-», 
the window moves so that the cursor remains visible. This also occurs 
when the cursor is at the top, bottom, or left edge of the window. 
However, the cursor (and the window) cannot go to the left of column 1, 
nor can it go higher than line 1. 

You can use the command key in conjunction with the arrow keys. 
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I 

Moves cursor to right | 

Moves cursor to left | 

Moves cursor up j 

Moves cursor down | 

Moves cursor to end of text on line; if| 
sequence is repeated, cursor moves to | 
right edge of window | 

Moves cursor to left edge of window | 

Moves cursor to top edge of window j 

Moves cursor to bottom line of text in | 
window ! 
I 



<BRK>, <BRK/CMD>: ISSUING A COMMAND 

See <Cmd>. 



<BSP>: BACKSPACING THE CURSOR 

To backspace the cursor and erase a character, press <Bsp>. To 
backspace the cursor without erasing a character, press <«->. 

The backspace key has different functions, depending on whether the 
Insert Mode is off or on. The <Bsp> key is sometimes labeled <BS> or 
<Back Space>. 



I <_>> 

I <<_> 

| <t> 

j < i > 

j <Cmd> <-»> 

[ <Cmd> «-> 

j <Cmd> <t> 

j <Cmd> <|> 
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<Bsp> 

<Cmd> <Bsp> 
<Ins> <Bsp> 



<Ins> <Cmd> <Bsp> 



Moves cursor left, deleting characters 

Leaves cursor in place; deletes text to 
left of cursor 

Moves cursor to the left one column and 
deletes any character there. The text 
to the right of the cursor is moved one 
character to the left (following the 
cursor 

Deletes all characters between the 
cursor and the left margin. The cursor 
is moved to the left margin and text to 
the right of it shifts left 



<CHG WIN>: WORKING IN A DIFFERENT WINDOW 

Pressing <ChgWin> moves the cursor to the next window. If there are 
only two windows, this alternates windows. If there are more than two 
windows, this moves the editor from window to window in the order in 
which the windows were created. To move to a specific window, press 
<Cmd> n <ChgWin>, where n is the window number. (Press <Ctrl+z> on 
earlier-model Ann Arbor terminals.) 



| <ChgWin> Moves cursor from one windowed file to j 

! another j 

! i 

| <Cmd> n <ChgWin> Moves to specified window I 
1 . — . i 



<CLOSE>: REMOVING/RESTORING TEXT 

Pressing <Close> removes characters, lines, or rectangular areas and 
moves the remaining text so that no gaps are left in your file. (By 
contrast, pressing <Erase> removes characters, lines, or rectangular 
areas and leaves a blank space where they were.) Text removed by 
pressing <Close> is placed in the close buffer. 

To delete the line where the cursor is located, press <Close>. To 
delete a number of lines or a rectangular area, press <Mark>, move the 
cursor, and press <Close>. You can also delete lines by pressing <Cmd> 
n <Close>, where n is the number of lines to be closed. 

To restore the last text you closed, press <Cmd> <Close>. Copies of the 
closed text can be inserted as many times and in as many places as you 
wish . 
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Any subsequent close will replace the text in the close buffer. Note: 
Pressing <Cmd> <Bsp> while in Insert Mode also replaces the contents of 
the close buffer with the newly deleted text. 

All material removed from a file by pressing <Close> or <Cmd> <Bsp> 
during your current editing session is placed in the changes file (#o) . 

I _ ! 

| <Close> Closes cursor line | 

| <Cmd> n <Close> Closes specified number of lines j 

| <Cmd> <Close> Restores closed line I 
I I 



<CMD>: ISSUING A COMMAND 

Pressing <Cmd> tells the editor that you want to issue a command (see 
Section 3 for commands that may be issued) . Pressing <CR> tells the 
editor to perform the command you have typed. 

To clear an unwanted command from the command line, backspace over it 
and press <CR>. 

The last command executed can be returned to the command line by 
pressing <Cmd> <Cmd> <Alt>. This line can be edited and then executed 
again by pressing <CR>. 

The <Cmd> key is sometimes labeled <Arg>, <Brk>, or <Brk/Cmd>. 



<Cmd> Allows you to issue a command 

<Cmd> <Cmd> <Alt> Repeats last command on command line 



<CNTL CHAR>: INSERTING A CONTROL CHARACTER 

Pressing <CntlChar> produces a small, bright block (|) on the screen. 
The | tells the editor that the next character typed is to be treated as. 
a control character to produce special codes, such as for page breaks 
and underlining. (Press <Ctrl+\> on Ann Arbor terminals.) 



[ <CntlChar> Makes block symbol on Ambassador and XL| 

I terminals 

I — - I 
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<CR>: MOVING CURSOR AND PERFORMING COMMANDS 

In the Edit Mode, pressing <CR> moves the cursor to left margin of the 
next line. If the cursor is at the bottom of the window, pressing <CR> 
also advances the window one-fourth of a screen. 

In the Command Mode, pressing <CR> tells the editor to perform the 
command you have typed . 



Moves cursor to left margin of next | 
line I 
1 



<CTRL>: USING CONTROL FUNCTIONS 

Holding down the <Ctrl> key shifts the keyboard into a third case, in 
which many keys perform special editor functions. Pressing <Ctrl> by 
itself does not perform a function; you must press another key in 
conjunction with the <Ctrl> key. The most commonly used keystrokes are 
described below. 

Earlier-model Ann Arbor terminals, which require the use of the <Ctrl> 
key, have the function written on the key. For example, the <a> key has 
LEFT printed in small blue letters on its front side. On the newer Ann 
Arbor, Ambassador, and XL terminals, many of these editor features have 
been replaced by function keys (the following control key functions will 
not work on Ann Arbor Ambassador or XL terminals). 

<Ctrl + a>. Pressing <Ctrl+a> moves the window 16 columns to the 
left. (The window cannot move to the left of column 1.) Pressing 
<Cmd> <Ctrl+a> moves the window to the left so that it displays 
columns 1-78 of the file. (Press <Left> on newer Ann Arbor, 
Ambassador, and XL terminals.) 

To change the number of columns moved by pressing <Ctrl+a>, see the 
set left and set window commands described in Section 3. 

<Ctrl + b>. Pressing <Ctrl+b> moves the cursor to an alternate file. 
If you have no alternate file, the editor will display the 
following error message: "*** No alternate file". (Press <Alt> on 
newer Ann Arbor, Ambassador, and XL terminals.) 

<Ctrl + C>. Pressing <Ctrl+c> interrupts a command. If there is no 
command to interrupt or if you do not press <Ctrl+c> fast enough to 
interrupt the command, the editor will display the following error 
message: n d operation to interrupt". (Press <Int> on newer 

Ann Arbor, Ambassador, and XL terminals.) 

<Ctrl+s>. Pressing <Ctrl+s> moves the window 16 columns to the 
right. Pressing <Cmd> <Ctrl+s> moves the window to the right so 



| <CR> 
I 

I 
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that the cursor is located in column 1 of the moved window. (Press 
<Right> on newer Ann Arbor, Ambassador, and XL terminals.) 

To change the number of columns moved by pressing <Ctrl+s>, see the 
set right and set window commands described in Section 3. 

<Ctrl + Z>. Pressing <Ctrl+z> moves the cursor to the next window. 
If there are only two windows, this alternates windows. If there 
are more than two windows, this moves the editor from window to 
window in the order in which the windows were created . To move to 
a specific window, press <Cmd> n <Ctrl+z>, where n is the window 
number. (Press <ChgWin> on newer Ann Arbor, Ambassador, and XL 
terminals . ) 

<Ctrl + [>. Pressing <Ctrl+[> sets and removes tabs. To set a tab, 
move the cursor to the column where a tab is desired and press 
<Ctrl+[>. To remove a tab, move the cursor to the column where the 
tab is to be removed and press <Cmd> <Ctrl+[>. (Press <S/R Tab> on 
newer Ann Arbor, Ambassador, and XL terminals.) 

<Ctrl+\>. Pressing <Ctrl+\> produces a small, bright block (§) on 
the screen. The | tells the editor that the next character typed 
is to be treated as a control character to produce special codes, 
such as for page breaks and underlining. (Press <CntlChar> on 
Ambassador and XL terminals.) 



<Ctrl+a> 



Moves screen 16 characters to left 



<Ctrl+b> 



Moves cursor to alternate file 



<Ctrl+c> 



Interrupts editor command 



<Ctrl+s> 



Moves screen 16 characters to right 



<Ctrl+z> 



Moves cursor from one windowed file to 
another 



<Ctrl+[> 



Sets tab at cursor position 



<Cmd><Ctrl+[> 



Removes tab at cursor position 



<Ctrl+\> 



Makes a block symbol on Ann Arbor 
terminals 



<DEL CHAR>: DELETING CHARACTERS 



Pressing <DelChar> deletes the character the cursor is on and moves all 
characters that are to the right of the cursor one column to the left. 
Characters deleted in this manner cannot be recovered. 
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To delete the character at the cursor and all characters to the right of 
the cursor on the same line, press <Cmd> <DelChar>. Characters deleted 
in this manner enter the erase buffer and can be restored by pressing 
<Cmd> <Erase> or <Cmd> -erase <CR>. 



<DelChar> Deletes character 

<Cmd> <DelChar> Deletes all characters to right of 

cursor 

<Cmd> <Erase> Restores erased text 



<DEL WORD>: DELETING/RESTORING A WORD 

Pressing <DelWord> on Ambassador or XL terminals deletes a single word 
or a series of characters up to a blank space and fills in the space 
left by the deletion. 

To delete a word or series of characters, place the cursor on any letter 
or on the space immediately preceding the characters and press 
<DelWord>. To restore the word or characters deleted in this fashion, 
press <Cmd> <DelWord>. 



| <DelWord> Deletes word 

I 

I <Cmd> <DelWord> Rest ores deleted word 
l 



<ERASE>: ERASING/RESTORING TEXT 

Pressing <Erase> on Ambassador or XL terminals removes characters, 
lines, or rectangular areas and leaves a blank space where they were. 
(By contrast, pressing <Close> removes characters, lines, or rectangular 
areas and moves the remaining text so that no gaps are left in your 
file.) Text closed by pressing <Erase> is placed in the erase buffer. 

To erase the line on which the cursor is located, press <Erase>. To 
erase a number of lines or a rectangular area, press <Mark>, move the 
cursor, and press <Erase>. You can also erase lines by pressing <Cmd> n 
<Erase>, where n is the number of lines to be erased. 

To restore the last text you erased, press <Cmd> <Erase>. Copies of the 
erased text can be inserted as many times and in as many places as you 
wish. 

Any subsequent pressing of <Erase> will replace the text in the erase 
buffer. Note: Pressing <Cmd> <DelChar> also replaces the contents of 
the erase buffer with the newly deleted text. 
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All material removed from a file by pressing <Erase> or <Cmd> <DelChar> 
during your current editing session is placed in the changes file (#o) . 



| <Erase> Erases text; leaves blank space 

| <Cmd> n <Erase> Erases specified number of lines 

| <Cmd> <Erase> Restores erased text 
I _ 



<HOME>: MOVING CURSOR TO UPPER LEFT CORNER OF WINDOW 

Pressing <Home> moves the cursor to the upper left corner of the current 
window. Pressing <Cmd> <Home> moves the cursor to the lower left 
corner . 



I — 

| <Home> Moves cursor to top left corner of 

[ window 

I 

| <Cmd> <Home> Moves cursor to bottom left corner of 

] window 

i 



<INS>: INSERTING TEXT WHILE TYPING 

Pressing <Ins> puts the editor into the Insert Mode. Pressing it again 
turns off the Insert Mode. When the editor is in Insert Mode, the word 
"INSERT" appears below the window. 

Text typed while the Insert Mode is turned off replaces existing text. 
Text typed while the Insert Mode is turned on is inserted into the line, 
moving existing text to the right. In addition, backspace functions 
behave differently while Insert Mode is turned on. 



I <Ins> Moves into and out of Insert Mode ! 
I I 



<INT>: INTERRUPTING A COMMAND 

Pressing <Int> interrupts an editor command. If there is no command to 
interrupt or if you do not press <Int> fast enough to interrupt the 
command, the editor will display the error message: No operation 

to interrupt". (Press <Ctrl+c> on earlier-model Ann Arbor terminals.) 
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| <Int> 



Interrupts editor command 



<JOIN>: JOINING LINES 

Pressing <Join> on XL terminals joins two lines. The line the cursor is 
on is lengthened by appending the following line of text to it. This 
deletes blank spaces or blank lines preceding the line to be joined. 

There is no comparable key on other terminal models. 

I 1 

| <Join> Joins two lines of text I 



<LEFT>: MOVING WINDOW TO THE LEFT 

Pressing <Left> moves the window 16 characters to the left. (The window 
cannot move to the left of column 1.) Pressing <Cmd> <Left> moves the 
window to the left so that it displays columns 1-78 of the file. (Press 
<Ctrl+a> on earlier-model Ann Arbor terminals.) 

To change the number of columns moved by pressing <Left>, see the set 
left and set window commands described in Section 3. 



<+LINE>: MOVING WINDOW FORWARD 

Pressing <+Line> moves the top fourth of what is in the window out of 
sight and redraws the screen to bring into sight the same number of 
lines at the bottom. The cursor stays at the same line number, or if 
that line is moved off the screen, the cursor goes to the top of the 
window . 

Pressing <Cmd> <+Line> moves the screen so that the line the cursor is 
on is positioned at the top of the window. 

Pressing <Cmd> n <+Line> moves the screen n lines forward. (To change 
the number of lines moved by pressing <+Line>, see the set line and the 
set +line commands described in Section 3.) 



| <Left> 



Moves screen 16 characters to left 



| <Cmd> <Left> 



Moves screen back to original position 



52 Editor Function Keys 



| <+Liiie> Moves top fourth of screen out of j 

| sight; brings equal number of lines j 

| into sight at bottom of screen | 

I ~ I 

| <Cmd> <+Line> Moves screen so cursor line is at top | 

| of screen | 

I ^ | 

| <Cmd> 73 <+Line> Moves screen n lines forward i 

l 1 



<-LINE>: MOVING WINDOW BACKWARD 

Pressing <-Line> moves the bottom fourth of what is in the window out of 
sight and redraws the screen to bring into sight the same number of 
lines at the top. The cursor stays at the same line number, or if that 
line is moved off the screen, the cursor goes to the bottom of the 
window. Pressing <-Line> has no effect if the top of the window is at 
line 1. 

Pressing <Cmd> <-Line> moves the screen so that the line the cursor is 
on is positioned at the bottom of the window. 

Pressing <Cmd> n <-Line> moves the screen n lines backward. (To change 
the number of lines moved by pressing <-Line>, see the set line and the 
set -line commands described in Section 3.) 



<-Line> Moves bottom fourth of screen out of j 

sight; brings equal number of lines | 

into sight at top of screen j 

<Cmd> <-Line> Moves screen so cursor line is at j 

bottom of screen ) 

<Cmd> n <-Line> Moves screen n lines backward ! 
I 



<LINE FEED>: MOVING THE CURSOR 

Pressing <LineFeed> moves the cursor down one line in the same column 
without erasing any text. Pressing <Cmd> <LineFeed> moves the cursor to 
the last line of text in the window, in the same column; if this 
sequence is repeated, the cursor moves to the bottom edge of the window. 
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<LineFeed> Moves cursor down one line j 

I 

<Cmd> <LineFeed> Moves cursor to bottom of window ] 
_ 1 



<MARK>: DEFINING A BLOCK OF TEXT 

Pressing <Mark> allows you to indicate a block of text to be used in 
conjunction with various editor commands and key functions . 

To mark several whole lines, move the cursor to the first line and press 
<Mark>. Then move the cursor to the last line by pressing <|>, <+Line>, 
or <+Page>. (The number of lines marked off is indicated in the message 
below the window, e.g., "MARK 4".) 

To mark a rectangular area: 

1. Move the cursor to the upper left corner of the rectangle and 
press <Mark>. 

2. Move the cursor to the right one column beyond the text to be 
marked by pressing <-»■>; this defines the width of the 
rectangle . 

3. Finally, move the cursor to the bottom by pressing <^> , 
<+Line>, or <+Page>; this defines the length of the rectangle. 
(The number of lines and columns marked off is indicated in the 
message below the window, e.g., "MARK 2x4".) 

To mark a portion of a line: 

1. Move the cursor to the first character of the text to be marked 
and press <Mark> . 

2. Move the cursor to the right one column beyond the text to be 
marked by pressing <-*■>. (The number of characters marked off 
is indicated in the message below the window, e.g., "MARK 
1x12".) 

After marking an area in this fashion, you can use a key function or 
editor command to change the marked area. For example, you can press 
<Pick> or <Cmd> pick <CR> to place a copy of the marked area in the pick 
buffer, or <Close> or <Cmd> close <GR> to remove the area from the file 
and place it in the close buffer, or <Open> or <Cmd> open <CR> to open 
the area. 



Some commands, such as center, fill, and justify, can be used only with 
marked whole lines. Other commands, such as caps, cease, and cover, can 
be used only with marked rectangular areas. 
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The mark function is normally turned off when you press a function key 
or issue an editor command. You can also turn off an unwanted mark 
function by pressing <Cmd> <Mark>. 

I _____ ! 

| <Mark> Defines a marked area j 

I I 
| <Cmd> <Mark> Turns off Mark Mode | 

L I 



<OPEN>: OPENING BLANK LINES 



Pressing <Open> inserts blank lines or rectangular areas in a file. To 
insert a blank line where the cursor is located, press <Open>. To 
insert a number of blank lines or a blank rectangular area, press 
<Mark>, move the cursor to define the area you wish to open, and press 
<Open>. 

You can also insert blank lines by pressing <Cmd> n <Open>, where n is 
the number of blank lines to be inserted in the file. 



Note that the dimensions of the opened area are not saved by the editor. 
Thus a subsequent press of the <Cmd> <Open> key does not return the area 
to its former state. 



[ <Open> Opens blank line j 

I i 

| <Cmd> n <Open> Opens specified number of blank lines | 



< + PAGE>: MOVING WINDOW FORWARD ONE SCREEN 

Pressing <+Page> moves the window toward the end of the file one screen 
at a time. You can move the window more than one screen by pressing 
<Cmd> n <+Page>, where n is the number of screens to be moved toward the 
end of the file. (To change the number of screens moved by pressing 
<+Page>, see the set page and the set +page commands described in 
Section 3 . ) 

Pressing <Cmd> <+Page> moves the cursor to the last line of the file. 
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<+Page> 

<Cmd> n <+Page> 
<Cmd> <+Page> 



Moves cursor forward one window 

Moves cursor forward specified number 
of windows 

Moves cursor to end of file 



<-PAGE>: MOVING WINDOW BACKWARD ONE SCREEN 

Pressing <-Page> moves the window toward the beginning of the file one 
screen at a time. You can move the window more than one screen by 
pressing <Cmd> n <-Page>, where n is the number of screens to be moved 
toward the beginning of the file. The window never moves beyond line 1. 
(To change the number of screens moved by pressing <-Page>, see the set 
page and the set -page commands described in Section 3.) 

Pressing <Cmd> <-Page> moves the cursor to line 1 of the file. 



<-Page> 

<Cmd> n <-Page> 
<Cmd> <-Page> 



Moves cursor backward one window 

Moves cursor backward specified number 
of windows 

Moves cursor to beginning of file 



<PICK>: COPYING/INSERTING TEXT 

Pressing <Pick> copies characters, lines, or marked rectangular areas 
into your pick buffer, from which copies can be placed anywhere in the 
file. It does not change the material that is picked; your text will 
appear untouched. 

To pick the line on which the cursor is located, press <Pick>. To pick 
a number of lines or a rectangular area, press <Mark>, move the cursor, 
and press <Pick> . You can also pick lines by pressing <Cmd> n <Pick>, 
where n is the number of lines to be picked. 



To place copies of the text stored in the pick buffer anywhere in your 
file, move the cursor to the desired location and press <Cmd> <Pick>. 
Copies of the picked text can be inserted as many times and in as many 
places as you wish. 

Any subsequent pick will replace the text in the pick buffer. 

All material picked during the current editing session is placed in the 
changes file (#p) . 
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<Pick> 



Places text in pick buffer 



<Crad> n <Pick> 



Places specified number of lines in 
pick buffer 



<Cmd> <Pick> 



Inserts contents of pick buffer 



_l 



<REPL>: REPLACING WORD OR SERIES OF WORDS 

Pressing <Repl> in conjunction with the replace interactive command 
(described in Section 3) allows you selectively to replace text with 
different text. 

To use this option, press <Cmd> replace interactive / text/newtext/ <CR>. 
This moves the cursor to the first occurrence of text. Pressing <Repl> 
substitutes newtext for text. To find the next occurrence of text, 
press <+Sch>. If you do not wish to replace text with newtext, press 
<+Sch> rather than <Repl>. 



<R(GHT>: MOVING WINDOW TO THE RIGHT 

Pressing <Right> moves the window 16 columns to the right. Pressing 
<Cmd> <Right> moves the window to the right so that the cursor is 
located in column 1 of the moved window. (Press <Ctrl+s> on earlier- 
model Ann Arbor terminals.) 

To change the number of columns moved by pressing <Right>, see the set 
right and set window commands described in Section 3. 



| <Repl> 



Replaces characters after issuing 
interactive replace command 



<Right> 



Moves screen 16 characters to right 



<Cmd> <Right> 



Moves screen so that column on which 
cursor is positioned is on left edge of 
window 
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<*SCH>: SEARCHING FORWARD FOR TEXT 

Pressing <+Sch> enables you to search toward the end of a file for words 
or characters. To search for specific words or characters, press <Cmd> 
word <+Sch> or <Cmd> phrase<+Sch> . All characters of the word or phrase 
must appear on the same line in the file. If the editor finds an 
occurrence of word or phrase, it moves the cursor to the first letter of 
word or phrase. To find additional occurrences, continue pressing 
<+Sch> until ""•"''■Search key not found" appears beneath the window. 

To search for text that appears only at the left margin of the window, 
press <Cmd> ^Jword <+Sch>. 

If the text being searched for is only one word, you can place it in the 
search buffer by positioning the cursor on its first character and 
pressing <Cmd> <+Sch>. The editor will search for the next occurrence 
of that word. Subsequent occurrences can be searched for by pressing 
<+Sch>. 

Text searched for remains in the search buffer until you place other 
text in the buffer. 

For additional capabilities of <+Sch>, see the regular expression 
command described in Section 3. 



| <+Sch> 


Searches from 


cursor position 


forward | 


| <Cmd> <+Sch> 


Places 


word at 


cursor position 


into | 




search 


buffer 


and searches for 


it from | 




cursor 


position forward 





<-SCH>: SEARCHING BACKWARD FOR TEXT 

Pressing <-Sch> enables you to search backward toward the beginning of a 
file for words or characters. In all other respects, it functions the 
same as the <+Sch> key. 

For additional capabilities of <-Sch>, see the regular expression 
command described in Section 3. 



| <-Sch> 


Searches from cursor position backward | 


j <Cmd> <-Sch> 


Places word at cursor position into | 
search buffer and searches for it from | 
cursor position backward i 
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<SPACE>: MOVING CURSOR TO THE RIGHT 

In the Edit Mode, pressing <Spacebar> moves the cursor one column to the 
right and erases existing text. In the Insert Mode, pressing <Spacebar> 
inserts blank spaces and moves existing characters to the right. 



| <Spacebar> Moves cursor one column to right ! 
I I 



<SPLIT>: SPLITTING LINES 

Pressing <Split> on XL terminals splits one line into two lines at the 
cursor position. The right-hand side of the line, including the 
character at the cursor position, is inserted as a new line on the line 
below, and the window is redrawn. 

Thre is no comparable key on other terminal models. 



| <Split> Splits line into two lines | 
l _ 1 



<S/R TAB>: SETTING/ REMOVING TABS 

Pressing <S/R Tab> sets and removes tabs. To set a tab, move the cursor 
to the column where a tab is desired and press <S/R Tab>. To remove a 
tab, move the cursor to the column where the tab is to be deleted and 
press <Cmd> <S/R Tab>. (Press <Ctrl+f> on earlier-model Ann Arbor 
terminals . ) 



| <S/R Tab> 


Sets tab j 


j <Cmd> <S/R Tab> 


Removes tab | 



<+TAB> OR <TAB>: MOVING FORWARD ONE TAB STOP 

Pressing <+Tab> on Ann Arbor terminals or <Tab> on Ambassador and XL 
terminals moves the cursor to the next tab position to the right. 
Default tabs are set every 8 columns beginning in column 1. 

I 1 

| <+Tab> or <Tab> Moves cursor right to next tab stop j 
l ___ _i 
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<-TAB> OR | SH IFT+TAB | : MOVING BACKWARD ONE TAB STOP 

Pressing <-Tab> on Ann Arbor Terminals or <Shift+Tab> on Ambassador and 
XL terminals moves the cursor to the next tab position to the left. 
When the cursor is at or before the leftmost tab, pressing <-Tab> or 
<Shift+Tab> has no effect. 



| <-Tab> or <Shift+Tab> Moves cursor left to next tab stop ] 
I I 



<+WORD>: MOVING FORWARD ONE WORD 

Pressing <+Word> on Ambassador and XL terminals moves the cursor forward 
one word. 

P— ! 

| <+Word> Move cursor to next word j 



<-WORD>: MOVING BACKWARD ONE WORD 

Pressing <-Word> on Ambassador and XL terminals moves the cursor 
backward one word. 



| <-Word> Move cursor to previous word ; 
l I 



SUMMARY OF EDITOR FUNCTION KEYS 



Key Name What Pressing the Key Does 



What Pressing 
<Cmd>+<Key> Does 



<Alt> Moves cursor to alternate file 

<Arg> Allows you to issue a command 

<Brk> Allows you to issue a command 

<Brk/Cmd> Allows you to issue a command 

<Bsp> Moves cursor left, deleting 

characters 

<ChgWin> Moves cursor from one windowed 
file to another 

<Close> Closes line 

<Cmd> Allows you to issue a command 

<CntlChar> Makes block symbol on 

Ambassador and XL terminals 

<CR> Moves cursor to left margin of 

next line 

<Ctrl> Shifts the keyboard into a third 

case; must be used with another 
key 

<Ctrl+a> Moves screen 16 characters to 
left 

<Ctrl+b> Moves cursor to alternate file 

<Ctrl+c> Interrupts editor command 

<Ctrl+s> Moves screen 16 characters to 
right 

<Ctrl+z> Moves cursor from one windowed 
file to another 



Pressing <Cmd> <Cmd> and 
then <Alt> repeats last 
command on command line 



Leaves cursor in place, 
deletes text to left of 



cursor 



Restores closed text 



Takes out of Command Mode 
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Key Name 



What Pressing the Key Does 



What Pressing 
<Cmd>+<Key> Does 



|Ctrl+[| Sets tab at cursor position 



|Ctrl+\| Makes block symbol on Ann Arbor 
terminals 

<DelChar> Deletes character 



<DelWord> Deletes word 

<Erase> Erases text; leaves blank space 

<Home> Moves cursor to top left corner 

of window 

<Ins> Moves into and out of Insert Mode 

<Int> Interrupts editor command 

<Join> Joins two lines of text 

<Left> Moves screen 16 characters to 

left 

<+Line> Moves top fourth of screen out 

of sight; brings equal number 
of lines into sight at bottom 
of screen 

<-Line> Moves bottom fourth of screen 

out of sight; brings equal 
number of lines into sight at 
top of screen 

<LineFeed> Moves cursor down one line 

<Mark> Defines marked area of text 

<Open> Opens blank line 



Removes tab at cursor 
position 



Deletes all characters to 
right of cursor 

Restores deleted word 

Restores erased text 

Moves cursor to bottom 
left corner of window 



Moves screen back to 
original position 

Moves screen so cursor 
is at top of screen 



Moves screen so cursor 
is at bottom of screen 



Moves cursor to bottom of 
window 

Turns off Mark Mode 



<+Page> Moves cursor forward one window 



Moves cursor to end of 
file 
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Key Name What Pressing the Key Does 



What Pressing 
<Cmd>+<Key> Does 



<-Page> Moves cursor backward one window 



<Pick> Replaces text in pick buffer 



<Repl> 



<Right> 



<+Sch> 



<-Sch> 



Replaces characters after 
issuing interactive replace 
command 

Moves screen 16 characters to 
right 



Searches from cursor position 
forward 



Searches from cursor position 
backward 



<Spacebar> Moves cursor one column to 
right 

<Split> Splits line into two lines 

<S/R Tab> Sets tab at cursor position 

<+Tab> Moves cursor right to next tab 

stop 

<-Tab> Moves cursor left to next tab 

stop 

<+Word> Moves cursor to next word 
<-Word> Moves cursor to previous word 



Moves cursor to beginning 
of file 

Inserts contents of pick 
buffer 



Moves screen so that 
column on which cursor is 
positioned is on left 
edge of window 

Places word at cursor 
position into search 
buffer and searches for it 
from cursor position 
forward 

Places word at cursor 
position into search 
buffer and searches for it 
from cursor position 
backward 



Removes tab 
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Key Name 



What Pressing the Key Does 



What Pressing 
<Cmd>+<Key> Does 



<"*> Moves cursor to right 



<■*■> Moves cursor to left 



<t> Moves cursor up 



Moves cursor to end of 
text on line; if sequence 
is repeated, cursor moves 
to right edge of window 

Moves cursor to left edge 
of window 

Moves cursor to top edge 
of window 



<|> Moves cursor down 



Moves cursor to bottom 
line of text in window 



Appendix A 
DEALING WITH CRASHES 

There are two kinds of crashes you may experience when using e: 
individual crashes (which affect only you) and system crashes (which 
affect all users). 

Individual crashes are caused when you: 

• Edit in the same directory as another user. 

• Fail to press a key for at least 30 minutes while in the 
editor . 

• Run out of your allocated "memory space." 

• Exit from a file using the exit abort command. 
System crashes are caused by: 

• Machine (hardware) problems. 

• Program (software) problems. 

• External events such as power failures and surges . 

If you experience an individual or system crash, you must recover from 
that crash using the same kind of terminal (Ann Arbor, Ambassador, or 
XL) you were using when the crash occurred. 

To recover from a crash, first type e <CR> in response to the % prompt. 
The editor will prompt you with the crash message: 
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The last time you used the Editor in this directory, you crashed or 
aborted. You have these choices: 

1. e will silently recover the last session and then update the screen; 
then you should exit before you continue editing. 

(Normally, select this option.) 

2. e will replay the last session on the screen; you should exit before 
you continue editing. 

(Select this option if e continues to crash in response to Option 1; 
press the interrupt key just before e completes the replay. The 
interrupt key on the e standard keyboard is control-\). 

3. e will ignore the crashed or aborted session and forge ahead as per 
the arguments with which it was invoked. 

(Select this option only if you do NOT wish to recover the last 
session's work.) 

4. e will return you to the shell, having done nothing. 

(Select this option if you do not know what to do and need 
assistance from your system administrators.) 
Type the number of the option you want, then hit <CR> : 



In most instances, you should choose the first option. 

If you run out of memory space or if you used the exit abort command 
(described in Section 3) , choose the second option. In this case, 
watch the replay of your editing session on the screen and interrupt it 
by pressing <Int> or <Ctrl+c> just before you reach the place at which 
the crash occurred. The replay is performed quickly, so some skill is 
required to interrupt at the desired point. Finally, exit from the file 
in order to save it. 



Appendix B 
EDITOR WORK FILES 



The editor maintains four hidden "work files" (.eel, .ekl, .eklb, and 
.esl). Since these files are created solely for the sake of the 
editor's internal mechanism, you cannot read and use them the way you 
can the #o and #p "changes files," which are created to protect you 
against accidental mistakes. 

To see the names of these hidden "work files," type Is -a <CR> in 
response to the % prompt . 

The .eel file is your change file. It is 

• Used by the editor to update your file after a crash has 
occurred . 

• Named .eel if you are working in your own directory or 

.eel. log inname if you are working in someone else's directory. 

The .ekl file is your keystroke file. It contains a history of all your 
keystrokes and is 

• Used by the editor for recovery purposes. 

• Named .ekl if you are working in your own directory or 

.ekl .loginname if you are working in someone else's directory. 

The .eklb file is your backup keystroke file. It is 

• Used by the editor for recovery purposes. 

• Created when have trouble recovering from a crash. 

• Named .eklb if you are working in your own directory or 

. eklb . loginname if you are working in someone else's directory. 

The .esl file is your state file. It contains information about the 
last file edited in each directory, including filename, cursor position, 
line length, state of Insert Mode, tab positions, and contents of the 
search buffer. Thus, it allows you to edit the last file you worked on 
by typing e <CR> rather than e filename <CR> in response to the % 
prompt. It is 

• Created by the editor every time you exit from a file. 

• Named .esl if you are working in your own directory or 

.esl .loginname if you are working in someone else's directory. 
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Appendix C 
VARIATIONS OF THE COVER COMMAND 



Section 3 describes how to use the cover command to insert 
rectangularly marked material from your close, erase, and pick buffers 
without shifting existing text to the right. 

This appendix describes four similar commands: blot, -blot, overlay, 
and underlay. 

The examples given in this appendix use material stored in the pick 
buffer. You can also use these commands with material stored in the 
close and erase buffers. In all cases, you must use rectangularly 
marked material and you must type the name of the buffer you use (do not 
press the key with the name of the buffer on it). Suppose you have 
placed the following material in your pick buffer by pressing <Mark>, 
moving the cursor, and pressing <Pick>: 



!####### # ## I 

!###### # ### | 

!##//## # #### I 

!##//# # ##### | 

# ###### | 

l## # ####//## | 

i i 

Place your cursor at the left margin of your file: 



Ijaaaaaaaaaaaaaaaaaaaaaaaaaa j 

| bbbbbbbbbbbbbbbbbbbbbbbbbbb j 

| ccccccccccccccccccccccccccc I 

I I 

I eeeeeeeeeeeeeeeeeeeeeeeeeee j 

jfffffffffffffffffffffffffff j 

I ggggggggggggggggggggggggggg j 
| hhhhhhhhhhhhhhhhhhhhhhhhhhh 

i I 
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70 Variations of the Cover Command 



BLOT 

If you press <Cmd> blot pick <CR>, everywhere a character appeared in 
your buffer, there will be a blank space in your file. 



aaaaa aaaa aaaaaaaa 
bbbbb bbbb bbbbbbbb 
ccccc cccc cccccccc 



eeeee eeee eeeeeeee 
fffff ffff ffffffff 
ggggggggggggggggggggggggggg 
hhhhhhhhhhhhhhhhhhhhhhhhhhh 



-BLOT 

If you press <Cmd> -blot pick <CR>, everywhere a blank appeared in your 
buffer, there will be a blank space in your file. 



I 

| aaaaaaa 
| bbbbbb 
I ccccc 



aaaaaaaaaa 
bbbbbbbbbbb 
cccccccccccc 



|eee e eeeeeeeeeeeeee 

Iff f f fffff ffff fffff 

I ggggggggggggggggggggggggggg 
I hhhhhhhhhhhhhhhhhhhhhhhhhhh 



L 
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OVERLAY 

If you press <Cmd> overlay pick <CR>, all characters in your buffer will 

replace characters in your text; blank spaces in the buffer will not 

replace characters in your file. 



I ####//##aaaaa#aaaa##aaaaaaaa | 

j ######bbbbb#bbbb###bbbbbbbb '. 

I #####ccccc#cccc####cccccccc " 

|#### # ##### | 

I ##eeeee#eeee//###eeeeeeee ! 

| ##f f f f f #f f f f####f f f f f f f f | 

I ggggggggggggggggggggggggggg I 

| hhhhhhhhhhhhhhhhhhhhhhhhhhh j 

i i 



UNDERLAY 

If you press <Cmd> underlay pick <CR>, characters in your buffer will 
replace only corresponding blank spaces in your file. 



I 1 

| aaaaaaaaaaaaaaaaaaaaaaaaaaa j 
j bbbbbbbbbbbbbbbbbbbbbbbbbbb j 
| ccccccccccccccccccccccccccc | 

\um # ##### i 

| eeeeeeeeeeeeeeeeeeeeeeeeeee \ 
jfffffffffffffffffffffffffff | 

I ggggggggggggggggggggggggggg i 
| hhhhhhhhhhhhhhhhhhhhhhhhhhh j 
i : i 



SUMMARY OF VARIATIONS OF THE COVER COMMAND 
Command What the Command Does 



blot close Places a blank space in your file everywhere a 

character appeared in the close buffer 

blot erase Places a blank space in your file everywhere a 

character appeared in the erase buffer 

blot pick Places a blank space in your file everywhere a 

character appeared in the pick buffer 

-blot close Places a blank space in your file everywhere a 

character appeared in the close buffer 

-blot erase Places a blank space in your file everywhere a 

character appeared in the erase buffer 

-blot pick Places a blank space in your file everywhere a 

character appeared in the pick buffer 

overlay close Replaces characters in text with corresponding 

characters from the close buffer 

overlay erase Replaces characters in text with corresponding 

characters from the erase buffer 

overlay pick Replaces characters in text with corresponding 

characters from the pick buffer 

underlay close Replaces blank spaces in your file with 

corresponding characters in the close buffer 

underlay erase Replaces blank spaces in your file with 

corresponding characters in the erase buffer 

underlay pick Replaces blank spaces in your file with 

corresponding characters in the pick buffer 
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Appendix D 
UNIX COMMAND OPTIONS 



You can add the following UNIX command options to the edit command when 
you first enter the editor. Many of these options change the way the 
editor works or the way your screen displays a file. 

-BULLETS, -NOBULLETS: ADDING/REMOVING CURSOR BLOCK MARKINGS 

Sometimes when you use the editor, bright blocks at the edges of the 
window indicate the row and column position of the cursor. If your 
window lacks these blocks or if you have removed them by issuing the 
-nobullets command option, you can produce them on your screen during 
the current editing session by issuing the following command: 

% e -bullets filename <CR> 

The editor is less expensive and faster to use when these bright blocks 
do not appear at the edges of your window. To remove them during the 
current editing session, issue the following command: 

% e -nobullets filename <CR> 



-HELP: ON-LINE EDITOR ASSISTANCE 

This command option displays the currently available options and their 
values along with the version number of the editor. 

% e -help <CR> 
-INPLACE, INPLACE: EDITING A LINKED FILE 

This command option allows you to edit and modify a linked file without 
breaking the link: 

% e -inplace filename <CR> 

Without this option, files that were originally linked to the edited 
file become linked to the comma file. The link is then broken when the 
comma file is deleted. 

You can override the -inplace command by pressing <Cmd> inplace <CR>. 
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76 Unix Command Options 



-NOCMDCMD: WASHINGTON OFFICE USERS 

This command option enables personnel with some Ann Arbor terminals in 
Rand s Washington, D.C., office to solve certain communications 
problems : 

% e - nocmdcmd filename <CR> 

If you use this option and if you wish to return the last command 
executed to the command line, press <Cmd> <Spacebar> <Cmd> <Ctrl+b>. This 
line can be edited and then executed again by pressing <CR> . 

-NORECOVER: RESTORING PREVIOUS VERSION OF FILE 

This command option begins your current editing session as defined by 
the .esl state file and ignores any .eel or . ekl files: 

% e -norecover filename <CR> 

If the editor has crashed or if you have exited from a file by using the 
exit abort option, this option enables you to avoid having to respond to 
the crash message. Do not use this command unless you do not want to 
recover from that crash. 



-NOSTICK, -STICK: RIGHT MARGIN CONTROL 

If you want to type further than column 75 without having the cursor 
either return automatically to the next line (as it does when you are in 
the Word Wrap Mode) or stick on the right margin (as it does when you 
have turned off the Word Wrap Mode), first use the -nostick command 
option when you enter your file: 

% e -nostick filename <CR> 

Then turn off the Word Wrap Mode with: 

<Cmd> -wp <CR> 

You can turn the stick option back on by using the -stick command option 
when you enter your file: 

% e -stick filename <CR> 

You can turn the Word Wrap Mode back with: 



<Cmd> wp <CR> 
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-NOTRACKS: EDITING A FILE AND RETAINING CURRENT WORK FILE 

This command option begins your current editing session without using or 
replacing the work files (.eel, ekl, and .esl) from your previous 
session: 

% e -notracks filename <CR> 
-REPLAY: RECOVERING FROM CRASH 

This command option allows you to replay an editing session using your 
keystroke file (.ekl) if you cannot otherwise recover from a crash. 

To use this option, you must first delete your .eel file if it exists: 

% del .ec1 <CR> 

Then rename your .ekl and/or .eklb files: 

% mv .ekl EK1 <CR> 
% mv .eklb EK1B <CR> 

Finally, use the -replay command option: 

% e -replay=EK1 <CR> 

You can interrupt the replay by pressing <Int> or <Ctrl+c>. If you do 
not wish to watch the replay on your screen, use the following option: 

% e -replay=EK1 -silent <CR> 



SUMMARY OF UNIX COMMAND OPTIONS 



Command 



What the Command Does 



e -bullets filename 
e -help 

e -inplace filename 

e -nobullets filename 
e -nocmdcmd filename 

e -norecover filename 

e -nostick filename 
e -notracks filename 

e -replay=EKl 

e -replay=EKl -silent 



Produces bright blocks at edges of window 
Displays on-line help file 

Allows you to modify file without breaking 
link 

Removes bright blocks from edges of window 

Solves communications problems for some Ann 
Arbor terminals in D.C. office 

Ignores any recovery processing of a prior 
crashed or aborted session 

Causes cursor not to stick on right margin 

Allows you to edit a file without 
disturbing the work files 

Uses keystroke file (renamed EK1) to replay 
editing session 

Uses keystroke file (renamed EK1) to replay 
editing session silently 



e -stick filename 



Causes cursor to stick on right margin 
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Appendix E 
TERMINALS AND KEYBOARDS 



The editor must be told the kind of terminal monitor and keyboard you 
are using so that it can interpret your keystrokes and place text 
properly on your screen. 

The editor usually finds this information in the TERM environment 
variable that is defined in your .login file. For example, if you 
regularly use an Ann Arbor terminal, your .login file probably contains 
the following line: 

setenv TERM aa; tset -e| 

If you regularly use an Ambassador or XL terminal, your .login file 
probably contains the following line: 

setenv TERM aaa; tset -e|H 



DEFINING YOUR TERMINAL MONITOR 

If you wish to use a terminal monitor that is different from the one 
defined in your .login file, use the UNIX command option: 

% e -term\na\=xxxx filename <CR> 

For xxx x , substitute the appropriate abbreviation from Table E.l. The 
UNIX command option -dtermcap tells the editor not to use its compiled 
description of your terminal. Instead, the editor will use your TERMCAP 
environment variable, or, if that does not exist, the description found 
in /etc/termcap. 

% e -dtermcap filename <CR> 



DEFINING YOUR KEYBOARD 

The TERMCAP environment variable and /etc/termcap contain descriptions 
of the terminal monitor, but not of the keyboard. Thus if you wish to 
use a terminal that is different from the one you usually use and if the 
editor does not have a compiled description for your terminal type, the 
editor will assume you are using a standard keyboard unless you use the 
-keyboard UNIX command option: 

% e -keyboard^*** filename <CR> 

For xxxx , substitute the appropriate abbreviation from Table E.l. If 
you wish to override the compiled description to indicate you are using 
a standard keyboard, substitute standard for xxxx. The standard editor 
keyboard is designed to be used on terminals with no function keys and 
can be used with all terminal monitors. See Table E.2 for a description 
of how to use a standard keyboard when performing editor functions. 

81 



82 Terminals and Keyboards 



Table E.l 



ABBREVIATIONS FOR TERMINAL AND KEYBOARD TYPES 



Terminal and Keyboard Types 



Abbr eviat ions 



Ann Arbor Ambassador and 
XL Series 



aaa, ambas, ambassador, aaaAf, aaas, 
aaa-W (N is 18, 20, 22, 24, 26, 28, 
30, 36, 40, 48, or 60) 
aa, aaO, annarbor, default 
aal 

vtlOO, vtl00w,citl01, citlOlw, tabl32, 
tabl32w, dmxl4, dmxl4w 
vt52 
hl9, kl 

3a, adm3a, la (ell) 
standard 



Ann Arbor S001901/2 
Ann Arbor (Model Q2878) 
DEC VT100 



DEC VT52 



Heathkit H19 & H89 
Lear Siegler ADM 3 a 
Standard keyboard 
Sun workstation 



sun 



You can also tell the editor you are using a different kind of keyboard 
by using the following UNIX command: 

% setenv EKBD xxxx <CR> 

For xxxx, substitute the appropriate abbreviation from Table E.l. Note, 
however, that the -keyboard option overrides this command. 

Finally, you can tailor your own keyboard specifications by using the 
following UNIX command option: 

% e -kbi\\e=specialfile filename <CR> 

For special file , insert the name of a file that contains a description 
of your keyboard's characteristics. 



Unix Command Options 

Table E.2 

USING A STANDARD KEYBOARD WHEN PERFORMING EDITOR FUNCTIONS 



Editor Comparable Keystrokes 

Function on a Standard 

Keys Keyboard 



<->> 


<Ctrl+l> 




«-> 


<Ctrl+h> 




<t> 


<Ctrl+k> 




< |> 


<Ctrl+j> 




<Alt> 


<Ctrl+-> or 


<Ctrl+x+a> 


<Bsp> 


<Ctrl+c> 




<ChgWin> 


<Ctrl+x+w> 




<Close> 


<Ctrl+v> 




<Cmd> 


<Ctrl+a> 




<CntlChar> 


<Ctrl+x+c> 




<DelChar> 


<Ctrl+w> 




<Erase> 


<Ctrl+x+e> 




<Home> 


<Ctrl+g> 




<Ins> 


<Ctrl+z> 




<Int> 


<Ctrl+\> 




<Join> 


<Ctrl+x+j> 




<Left> 


<Ctrl+x+h> 




<+Line> 


<Ctrl+f> 




<-Line> 


<Ctrl+d> 




<Mark> 


<Ctrl+u> 




<0pen> 


<Ctrl+o> 




<+Page> 


<Ctrl+r> 




<-Page> 


<Ctrl+e> 




<Pick> 


<Ctrl+p> 




<Repl> 


<Ctrl+]> or 


<Ctrl+x+r> 


<CR> 


<Ctrl+m> 




<Right> 


<Ctrl+x+l> 




<+Sch> 


<Ctrl+y> 




<-Sch> 


<Ctrl+t> 




<Split> 


<Ctrl+x+b> 




<+Tab> 


<Ctrl+i> 




<-Tab> 


<Ctrl+x+u> 




<Tabs> 


<Ctrl+x+t> 




<+Word> 


<Ctrl+n> 




<-Word> 


<Ctrl+b> 





NOTE: The notation <Ctrl+x+key> instructs you to hold down 
<Ctrl> while pressing the <x> and then the indicated second key. 



SUMMARY OF TERMINAL AND KEYBOARD OPTIONS 



Command What the Command Does 

i — . 



i 

e -dtermcap filename Overrides compiled code for terminal type 

e -keyboard=xxxx filename Tells editor you are using keyboard defined 

by xxxx 

e -terminal=xxxx filename Tells editor you are using terminal defined 

by xxxx 
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abbreviations 

editor commands 9 

keyboard types 81 

terminal types 81 
adjust buffer 6 
alternate 

files 5; 16; 43; 48 

windows 47 
ambassador terminal 43 
ann Arbor terminal 43 
a. out file 3 

area-defining for editor commands 9 
arrow keys 

<!> 43 

<•!■> 43 

«-> 43 

<-» 43 

asterisk in regular expression 26 

backslash in regular expression 27 
backspace the cursor 44 
backup files 

#o 7; 13 

#p 7; 23 
block | 46; 48 
blot 

[blot close] 69 
[blot erase] 69 
[blot pick] 70 
-blot 

[-blot close] 69 
[-blot erase] 69 
[-blot pick] 70 

box 

drawing [box] 10 

removing [blot box] 11 
brackets in regular expression 25 
break line into two lines [split] 21; 31; 58 
buffer 

adjust 6 

close 6; 12 

definition of 6 

erase 6 

pick 6; 22; 55 

search 6 
-bullets option 75 
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caret in regular expression 

not used in conjunction with brackets in regular expression 

used in conjunction with brackets in regular expression 25 
center text [center] 12 
changes .files 

#o 5 

#p 5 

changing all letters to uppercase 11 

changing defaults for editor keys and commands 29 

changing windows 45 

close 

buffer 6; 12 

<Close> 45 

rectangular areas 12 
combine two lines [join] 51 
comma file 7 
commands 

blot box [blot box] 11 

box [box] 10 

caps [caps] 11 

cease [cease] 11 

center [center] 12 

close [close] 12 

-close [-close] 12 

command [command] 13 

-command [-command] 13 

cover close [cover close] 14 

cover erase [cover erase] 14 

cover pick [cover pick] 13 

delete [delete] 15 

dword [dword] 15 

-dword [-dword] 15 

erase [erase] 16 

-erase [-erase] 16 

exiting from a file [exit] 17 

exiting from a file [exit dump] 17 

exiting from a file [exit nosave] 17 

exiting from a file [exit quit] 17 

fill [fill] 19 

foreground [fg] 32 

goto [goto] 20 

insert adjust [insert adjust] 12; 19; 20; 21 

join [join] 21 

-join [-join] 21 

justify [justify] 21 

name [name] 22 

open [open] 22 

pick [pick] 22 

-pick [-pick] 22 

range [range] 23 

-range [-range] 23 

? range [? range] 23 

redraw [redraw] 24 



regexp [regexp] 24 
-regexp [-regexp] 24 

replace interactive [replace interactive] 28 

replace [replace] 27 

-replace [-replace] 27 

replace show [replace show] 28 

save [save] 29 

set ? [set ?] 30 

set left [set left] 29 

set +line [set +line] 29 

set -line [set -line] 29 

set line [set line] 29 

set lmar [set lmar] 30 

set nostick [set nostick] 29 

set +page [set +page] 29 

set -page [set -page] 29 

set page [set page] 29 

set right [set right] 29 

set rmar [set rmar] 12; 19; 21; 30 

set stick [set stick] 29 

set width [set width] 30 

set window [set window] 29 

set worddelim alphanum [set worddelim alphanum] 30 

set worddelim whitespace [set worddelim whitespace] 

split [split] 31 

-split [-split] 31 

stop [stop] 32 

tab [tab] 32 

-tab [-tab] 32 

track [track] 33 

-track [-track] 33 

update [update] 34 

-update [-update] 34 

width [widths] 12; 19; 21 

window [window] 34 

-window [-window] 34 

wp [wp] 35 

-wp [-wp] 35 
control 

character | 46; 48 

functions 47 

key <Ctrl> 47 
control key combinations 

<Ctrl+a> 47 
control key combinations 

<Ctrl+[> 48 

<Ctrl+\> 48 

<Ctrl+b> 47 

<Ctrl+c> 47 

<Ctrl+s> 47 

<Ctrl+z> 48 
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copy 

[pick] 22 
<Pick> 55 

rectangular areas <Pick> 55 
core file 3 
crash 

individual 65 

message 65 

recovering from 17; 65 
system 65 
create 

alternate file 5 
alternate window 34 
file 3 

separate file with tab stops 32 
cursor 

definition 5 

move backward to tab stop 59 

move backward word 59 

move forward one word 59 

move forward to next tab stop 58 

move to lower left corner 50 

move to upper left corner 50 

movements 5 

delete 

character 48 

current file within editor [delete] 15 

word <DelWord> 49 

word [dword] 15 
dollar sign in regular expression 26 
draw 

horizontal lines [box] 10 
vertical lines [box] 10 
-dtermcap option 81 

e Rand Editor Version 19 3 

.eel files 67 

edit a file [e] 16 

editor commands abbreviating 9 

. ekl files 67 

.eklb files 67 

eliminate extraneous characters from screen 24 
erase 

buffer 6 

<Erase> 49 

rectangular areas 16 

text 49 

restoring 49 
error messages 

"Command ' . . . ' ambiguous" 9 

"No alternate file" 43; 47 

"No operation to interrupt" 47; 50 
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.esl files 67 
exit abort 7 
exit 

file without saving changes 17 

from file [bye] 17 

from file [exit] 4; 17 

from file [exit abort] 17 

from file [exit dump] 17 

from file [exit nosave] 17 

from file [exit quit] 17 

from file without saving changes 34 

quickly from file [stop] 32 

filename 

blank spaces in 3 

length 3 
files 

alternating 5; 16; 43; 48 
a . out 3 
backup 7 
comma 7 — 
core 3 

creating [e filename] 3 
definition 3 
linked 75 
names of 3 
naming a 3 

renaming within the editor [name] 22 
function keys 43 

help file 75 

-help option 75 

horizontal lines -drawing 10 

-inplace option 75 
insert 

characters 50 

control character 46 

copied text 55 

copied text [-pick] 22 

insert adjust [insert adjust] 12; 19; 21 

picked text 55 
interactive replace 56 
interrupt a command 47; 50 
issue 

command 43; 44; 46 
series of commands 13 



join two lines [join] 21; 51 
justify lines [justify] 21 
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-keyboard option 81 
keyboards 81 
keys 

<Alt> 43 

<Arg> 43 

<Brk> 44 

<Brk/Cmd> 44 

<Bsp> 44 

<ChgWin> 45 

<Close> 45 

<Cmd> 46 

<Cmd> <Cmd> <Alt> 46 

<Cmd> <+Sch> 57 

<Cmd> <-Sch> 57 

<CntlChar> 46 

<CR> 47 

<Ctrl+b> 43 

<DelChar> 48 

<DelWord> 49 

<Erase> 49 

<Home> 50 

<Ins> 50 

<Int> 50 

<Join> 51 

<Left> 51 

<+Line> 51 

<-Line> 52 

<LineFeed> 52 

<Mark> 53 

<0pen> 54 

<+Page> 54 

<-Page> 55 

<Pick> 55 

<Repl> 56 

<Right> 56 

<+Sch> 57 

<-Sch> 57 

<Spacebar> 58 

<Split> 58 

<S/R Tab> 58 

<+Tab> 58 

<-Tab> 58; 59 

<+Word> 59 

<-Word> 59 

line length changing [width=] 12; 19 
linked file 75 
. login file 81 

lowercase changing to [cease] 11 
mark 

block of text 53 
turning off 54 



move rectangular areas using mark 53 

move text using mark 53 

move the cursor 5; 43; 47; 52; 58 

backward one word 59 

backward to tab stop 59 

forward one word 59 

forward to next tab stop 58 

to a specified line 20 

to alternate window 47 

to an alternate file 43 
move the window 

backward 55 

forward 51; 52; 54 

left 47; 51 

right 47; 56 



name a file 3 
-nobullets option 75 
-nocmdcmd option 76 
-norecover option 76 
-nostick option 76 
-not racks option 77 



#o file 5; 55 

open blank lines 22; 54 

overlay 

[overlay close] 69 

[overlay erase] 69 

[overlay pick] 71 



#p file 5; 55 

period in regular expression 25 
pick 

buffer 6; 22; 55 
<Pick> 55 

rectangular areas 22 
text [pick] 22 

Rand Editor Version 19 3 
rectangular area 

closing 12; 45 

erasing 16; 49 

marking 53 

opening 22; 54 

picking 22; 55 
regular expression 

asterisk 26 

backslash 27 

brackets 25 

caret in conjunction with brackets 25 
caret not in conjunction with brackets 
dollar sign 26 
period 25 
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remove 

alternate window 34 

multiple tabs 33 

tabs 32; 58 

tabs [-tabs] 32 
rename a file within the editor [name] 22 
replace 

asterisk in regular expression 26 
backslash in regular expression 27 
brackets in regular expression 25 

caret in conjunction with brackets in regular expression 25 
caret not in conjunction with brackets in regular expression 26 
dollar sign in regular expression 26 
interactive [replace interactive] 56 
period in regular expression 25 
text 56 

text [replace] 27 

text [replace interactive] 28 

text [replace show] 28 

word or series of words 56 
-replay option.- 77 
restore 

closed text 45 

closed text [-close] 12 

deleted word 49 

deleted word [-dword] 15 

erased text 16; 49 

split lines [-split] 31 
retrieve 

centered text [insert adjust] 20 

filled text [insert adjust] 20 

justified text [insert adjust] 20 
reverse letters to upper/ lowercase 11 
right margin-setting [width=] 19 

save current file without exiting from the editor 29 
search 

asterisk in regular expression 26 
backslash in regular expression 27 
backward for text 57 
brackets in regular expression 25 
buffer 6 

caret in conjunction with brackets in regular expression 25 

caret not in conjunction with brackets in regular expression 26 

dollar sign in regular expression 26 

for text on left margin of window 57 

forward for text 57 

period in regular expression 25 

set 

multiple tabs 33 
tabs 58 



special characters with search and replac 
specifying lines for search and replace 
split 

two lines 58 

two lines [-join] 21 

two lines [split] 31 
standard keyboard 81; 82 
-stick option 76 
stopping a command 50 

tabs 

removing 32; 33; 48 

setting 32; 33; 48 
TERM aa 81 
TERM aaa 81 
TERM environment 81 
-terminal option 81 
terminal types -abbreviations 81 
terminals 81 

tilde abbreviation in filenames 16 
track current and alternate files [track] 

underlay 

[underlay close] 69 

[underlay erase] 69 

[underlay pick] 71 
UNIX command 

-bullets 75 

-dtermcap 81 

feed [feed] 18 

-help 75 

-inplace 75 

-kbfile 81 

-keyboard 81 

-nobullets 75 

-nocmdcmd 76 

-norecover 76 

-nostick 76 

-notracks 77 

-replay 77 

run [run] 28 

-stick 76 

-terminal 81 
UNIX 

command within the editor [feed] 18 
command within the editor [run] 28 
uppercase 

changing case [cease] 11 
changing to [caps] 11 

variations of the cover command 69 
vertical lines drawing 10 
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width [width=] 12 

windows 

changing 45 
creating 34 
moving backward 52; 55 
moving forward 51; 54 
moving left 47; 51 
moving right 47; 56 
moving to alternate window 
removing 34 

word wrap 35 

work files 67 



XL terminal 43 
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